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From the Editor 


W appy New Year! It's a great time to lie involved with the universe of Apple prcxlucfs. More 
first-time Mac iisers are createil every clay; loog-timers stay with the platform. The iPhone is 
nearly llie best-selling sniart piioiie, Sahtri continues to gain wel>-s[iare. Businesses 
increasingly choase OS X as their client and server platform. Ail of this drives developer interest 
and opportunity, Mac'lech Magazine remains dedicated to helping you understand all of this. 

January 2009 - Macworld is in full swing, and yon’re reading one of our most liglnly packed 
issues. Well cover the main announcements from tlie show in an upcoming Lssties, but for now, 
revel in the knowledge here and now. 

Our cover story brings you all the details that yoifd need to know alKHit location-based 
metadata, and how to use it to organize pliotos willi GPS data. Learn tlie coneej>ts, acronyms and 
tcx>l 5 to deal with this useful Icxation information. 

We continue our introduction to Python^ and learning Python on the Mac in the month's Mae 
in the ShelL Python is ceitainly one of the most important languages available today for 
developers, aspiring developers and system administrators. Gel in on the ground lltK)r and follow 
along! 

Greg Neagle teaches the inatiy options and methods for creating and delivering installer 
packages. If you're a system administrator, tliere’s no better way to deliver apt>lications and scripts 
to a multitude of riiachines. If yoir’re a develojx^r, it's im[iortani to know how to package your final 
product in a way that makes it flexible and easy for users and administrators to install. 

In The PoacI to CiKk% Dave Dribin brings a review of the journey ihus far, If ycnfve been 
following along, youVe covered a lot of ground. If you're loijking jump in, now's the time! 

Think version control is just for developer? Think again! System Administrators should Ixf 
familiar with ver.sitm contrt>I to store the muliitude of texl-ba.sed configuration files that ccmtrt>l OS 
X and OS X Server systems, ve coveretl several version control systems in the past, and this 
rnonlh, Ryan Wilcox covers Subversion tips for avoiding tnxible. 

1-requent caintiibutar Mihalis 'Isoukalos intrtxliices us to Graphviz, an incredible, open source 
graphing package. Using the dot language, Graphviz can dynamically build graphs of just about 
any data you can supfily, fr<nn code statistics lo system perfonnance 

Noah Gift presents part 2 of the series, 'Integrating OS X with OpenLDAP." You 11 often find 
OS X systems that need to exist without OS X Ser\^er and Open Directory. Well, a Linux machine 
running OpenLDAP can easily serve as a centra! directory for OS X machines. 

This nicjnth's Geek Guide teaelies you everything you need lo know wlien sliopping for a 
printer, lunally, this month’s Madech Spotlight features Rich Siegel from Bare Bone.s Software. Bare 
Bones has been a sUiple of the Macintosh tech experience since before OS X was on the scene. 
Check out tlie advice from one of die kmgest on the scene. 

If youYe reading this at the Macworld show, please don't forget to stop by the MacTech booth! 
hnjoy, and well .see you next month! 


Ed Marczak, 
Executive Editor 
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Mac in the Shell 


IndeiiLatioriErior: unexpected indent 
Program exited. 


by Edward Marczak 


Learning Python 
on the Mac: 

Code Blocks 

Aka: the big indent 

_ J 


So, wlmt'5 this all It all comes down to flow control: 

clux^sing one path of code over another based on some 
comparison or value. The chosen path will run or skip a block 
of code. Tliese code bkxks are grouped together by a common 
level of indentation. Before we begin, you .should understand 
that tile wliitespace used can l>e any whitespace - tabs t>r any 
number of spaces. However, choose onesfyiel Choose one and 
stick to it. Spaces vs. tabs can become a bit of an argument. I 
used to I->e a tab adherent, hut now use two spac'es. Spaces are 
fixed in a fixed widili font, display easily in a bn>wser or on 
paper, and make it easy on tidy-like apps. Choose tlie style that 
suits you best; just be consistent. I ll be using two spaces in iny 
article.s. Any decent text editor (BBKdil, TextMate, Xct.)dc, and 
so on) should let you set what tlie tal> key actually inserts. 

This particular column imiy seem tt) jump around a bit, but 
if you read tlirough, you1l see how it huikls and all ties 
togedier by the end. Let’s get startetl with the most basic: the 
If siatcnient. 


Introduction if 


rhe previous two columns have Ixrgun to introduce us to 
the I’yihon st iipting language, and some OS X-specific w^uys to 
start scripting, and OS X-specific issues. 'I'he first article got into 
tlie very basics of Python and the Python interpreter. The 
.second ariicle got inio ihe specifics of the siring collection lyfx. 
This month, w^^*ll see how Python im[]>lemeiits flow control and 
how to specify blocks of code. 

Get Used To It 

U)ve it or leave iK bin in any rase, get u.sed lo it: Python 
uses wliites[}ace indentation levels to specify blcH.k.s of code. If 
youfe new to .scripting altogether, thi.s may not seem cxld. 
However, if you already have experience with ant>ther 
language, C, perl or PHP, perhaps—a curly brace language— 
this will lx something you need to adjust to. Wliitespace isn't 
just used to make ctxle veackilile or pretty, iPs a ftmetion of tlie 
language. You'll reali;^e this if you tried any of tlie samples from 
la.si month and mistakenly indented anything. For those of you 
who are perfect typists, though, here’s liie effect (note the 
leading space on the second print line): 

! /usr/bin/pythoti 

print **Indentation is important" 
print “in Python! 

Running this code prcxluces this error; 


The if slatement checks a condition and i/it is taie, nms 
a block of ctxle staienients, Tlie general form is: 

if condition: 

1 hat's it. It's nicer to see in action, though. You can type; this in 
and run it: 

/h /ufsr/bin/python 
x=3 

if X > lUi 

print “The value of x ia gr&ater than 10!” 
print it really is." 

print "Done.** 

Since flic value of x is not greater ihan 10, the two 
indented print lines (a code l>Iock) is .skip[>ed. All this program 
])i ints is "Done.'". However, if we change x to, say, 20, and run 
the program again, the cone lit ion in ihe if sialemenl becomes 
Lnie (yes, x is greater than 10), and the two [irint statements in 
the if axle bkxrk are executed. 

No curly braces, no BFXilN or RND statements, just itie 
level of indentation. Code blocks can also be nesied. If ihere is 
a eondiiion that you’d like to check that only ap]>iies within a 
j^aiticLilar code bkxk, its code will staH at a new level <)f 
indentation. For example: 
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/usr/bin/python 
x-55 

if K > 10; 

print '‘The value of x 1b greater than 10!” 
print '‘Ysn, It really ls,“ 
if X > 30t 

print 'In fact, lt‘s greater than 50!" 
print "It ia Is." % x 

print "Done," 

All of Ltic print ,stak‘iiionLs in this program will l>e executed. 

Truth 

G)inpari,so*i oix-rators reduce their deciskms u>, and act on 
one thing: inith. Not some phiJosophicil, grey area truth, but a 
Boolean 'Ime or False. Like many other languages, “false" is 0. 
True, llien am only lx: one thing: m>i false* Wliile most jxojile 
then interpret true as it’s actually any non-zero value, llie 
following is tme: 

if 1: 

print "U‘s true!" 


But he aware that thi.s is true also: 
if 18; 

print 'It*s true!" 


and tliis: 
if -12; 

print 'It's true!" 

A genuine Boolean type was added in Python version 2,3. 
Tilts inlnxluced the keywords True and False (m>te the 
capitalization). While True and False are actually just 
another representation of 1 and 0, respectively fBotileans are a 
subtJass of the int clasKs), the ahsiraction helps make aide more 
readable. If you're kx^king at someone else\s code and the value 
“r is Ixing passed into functions or returned from ftinctioas, 
it’s rough to derive its meaning. However, "Trtie" and “False" 
give a much Ixtier indication of their meaning at first look. 
Here’s a simple cxxle snippe^t that illustrates Ikxilean values in 
Pytlion: 

print_it-True 
if print_it; 

prliiL "The variable Is true!" 

print type is %s,* X type(print_it) 

'lliis foundation will help you better understand what the 
comparison operators are doing. 


Comparison Operators 

When writing a comparison stalement, you will need to 
use an opt^rator that spetlRes the compari.son to make. Here is 
a list of i^ion’s comparison operators: 

< Less than 

> Greater than 

= Equality 

!= Not equal 

>- Greater than or equal to 

<- Less dian or equal to 

is Equal 

not Not equal/negation 

You've already seen the > operator in atiion. Tlte < 
operator works similarly. The double equal sign (=) is used to 
test for equality. 'Hus Ls different than tlie assignment operator 
or, single equal), Ifs a common mistake in C, C++ and PHP 
to Lise the assignment opcrnitor when you meant to use die 
ecjuality comparison operator* Fortunately, the python 
interpreter will flag this as an enxir* Kunntng this cxxle snippet: 

if x“5: 

print "x iB 3" 

*,*at runtime will yield : 

SyutaxError; invalid syntax 

The remaining operators are [>retty self-explanatory, with 
perliaps die exc'eption of the "^is" operator. Is tests for object 
equivalence, and is different ihan the simple equality 
comparison ofXTator. As outlined in the first attide in tliis 
series, everything in Pytlion is an object. Object ideniitiem may 
be pointing to the .same object, and this is what is tests. Let's 
take a kM>k at an example to .solidify dlls concept: 

#1 /usr/bin/python 

x=3 

y-x 

If y ia k: 

if y and x point to the object 

print 'Yes, y is x: y is at %s and x is nt %s," % (id(yj, 

id U)) 

x-7 

y=7 

if y is x: 

// y and x both point to the same int object 
print "Still, y is x: y ts at %s and it Is ai Xa.** % 

(id(y), id(x)) 

x=5 

y=10-5 
if y is x; 

// 5 is 5, no matter how it's derived 

print "Once again,, y in x: y is at %s and x is at %s*" X 
Sid(y), id(x)) 

y=2 

x=3 
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if y is x: 

prinl “y is now not x* so* this will not print," 


Integers can be compared diretily, loo: 


if K is not 0; 
blah 

IJke l!ic fkxjlcan class, using this style greatly increases the 
readability of code. However, in a future article when we get 
into writing our own classes and treating objects, the is 
operator t>ecomes much more itTiportant than syntactic sugar 

While 

The while sLatenient aLst) inipiements a type of flow 
control Unlike the if statement, which decides to run a block 
of ctxie entirely or not, while forms a (cxip, which repcalcdly 
tests a given condition (leforL^ nmning a block of code, and 
keeps Rinning its block of code while the condition is true. 
Look at this common snipfiel of axle: 


the_nuniber = 0 

while rhp n nmh pr < lOt 

print "The connt is Xs," % ihe^nuaber 
\ he_nuraher+=l 

print "Done!'' 


Running this .snippei will prim the numbers i) through 9, and 
then prim "Done!" When the interpreter encounters the while 
kyop, the variable the_rmmber meets the condition: it is less 
than 10, so the while code hkx’k is ext'culed. Immediately we 
prim The count is,..” li>lU)wed by a line that increments 
the_number by ime (the plus-equals notation is the 
equivalent of taking the variable on llte left hand side and 
adding a value to it.self. In other words, variable = variable + 1). 
When the interpreter reaches the end of its code block, it loops 
back to the top and runs the test again. If il is still ime, the code 
block is am again. If the ccmdiiion is now false, the code block 
is skippcxl, and execudon is resumeil at the statement following 
the while code block. 

The For Loop 

Another type of flow control l(X)p is the for ItKjp, You 
may have seen a for kxrp in oilier languages, but don’t let those 
lx “false friends" - the for Icxip in l^thon is different than any 
of them. 

Python's for \oop iterates over a .scx]uence. We learned 
alxnil setjuences in the first Ix'arn Python on the Mac article in 
die NDvemf>er issue. Sequences cover many of Pydion's dala 
types, mckiding lists, dictionaries and even strings. We can 
generate a numeric li.st setfuettee using the range function. 
An example using die interactive inlcTpreter (which you access 
simply by typing python in a shell): 
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»> print range(1,5) 

U. 2, 3, 41 

Now that we see range rclLims a sequence, let’s kx>k iiX the 
for Itxjp. Ilie getieric fonn of the loop is: 

for [variable] in [setfiienee]: 
txxle hltxk 

As a more clirect example: 

for i if) range Cl. 5): 
print I 

...which outputs; 

1 

2 

3 

4 

Remem[>cr that the Python ft)r lcx)p works with all sequences. 
Even strings are just sequences of chanictets. Wt? r.in sec this 
back in the interactive interpreter: 

»> K = “beiio“ 

»> for 1 in 
,., print i 

h 

e 

1 


1 

o 

What Else? 

Each flow contn^i type presented ulxjve can have an 
optional else clause. Tile else clause ctxle blm‘k is exmiied 
when tlie condition being tested is false. Tlie ca.siest case to 
visualize is the if statement; 

St - 5 

ir 31 > JO: 

print "x is greater than 10" 
else; 

print "x is less than 10" 

Itiis reads in a very Englishlike manner: if x is gieater than 
10, run the first ctxle hkx.‘k. If x is nnyching else, run the else 
code block. Tills also applies to the while kK>p. Mtxlilying the 
while loop we used earlier; 

the Tiumher = 0 
while the nmaber < 10: 

print "The count Is %s. residing at %s." % {the_nuwber, 
id(the_number)) 
the_nuntber^l 
else: 

print “running the else bluck" 
print "Done!" 
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Tills runs [he while code block, but when x is 
incremented to 10 and the condition Is tested again, the else 
block will run. Unlike the if siaiement, in the case of the 
while (and for) loop, the else block will always l)e 
invoked in simple cases. The next section will describe two 
flow control statements that can change this. 

Continue and Break 

For one reastm or another, you niiiy want to skip a 
particular iteration of a loop, or, end it early. The 
continue and break stalcmentHS, respectively^ do just 
this. 

continue stops running the code block that it's in, 
and starts the loop again at the lop. For example, this code 
snippet will output odd numbers: 

for i in ranged, 11); 
if i % 2 — 0: 

continue 
print 1 

Inside the loop, the first .statement decides if 1 is even. If it 
is, we simply continue - skipping the remainder of the code 
block and starling the loop From the lop. 

The break statement breaks out of the code block it's in 
and terminates a loop. 


thfi_nunber “ 0 
while True: 

print “The count is % the^iHiinber 

the_nunber+=l 

tf the..number ) 10: 

break 

This is a contrived example, but nicely illustrates the 
break staiement A while statement with a condition of 
True would normally never terminate. Inside of this loop, 
however, we test the value of the_nuinber. If 
the_number is greater than 10, we Issue break and 
terminate the loop. 

As alluded to in the previous section, the break 
statement entirely breaks out of a lot^p. This means 
skipping the loop’s else portion as well 

Whew 

We covered a good amount of ground this month. Flow 
control is really the brains behind any code. Python has 
everything one would expect from a language. The if/else, 
wliile/else and for/else loops, crafted wisely, lead your 
ct)de down the right path. From the beginning of this serie.s 
through now, you can WTite some very basic (command¬ 
line) applications with logic. Next month, we'll get into 
Python functions and libraries. 
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Getting Started with 
REALBasic—Part 4 


Designing the Appiication 



lUiALbasic is a Rapid Application Developmeni (RAD) kK>i 
from lUiALSoIrware. In the Iasi coiumn \vc iinplcnienied a big 
chunk of the data)>a!)e for uur stock tracker application, 
REALbasic 4 and 4.1 have been released in rlie interim anci wc’ll 
move up to using that version as tin ere are a numix^r of bug 
fixes and improvements in ii. 

Back to it 

IVe lieen extremely Imsy getting the last two releases of 
REALlrasic out and apologi^^e to everyone for the hiaais, 

'lliis time the focus is going to f)e on gelling several stocks 
symbols into the datal>iLse, retrieving quotes for eacli of them 
and storing the data Irack in the database, 

Right now die daialiase is clemmed out every time we start 
up. While it makes for a nice dean starting point, it's really not 
riiat useful in an appiication that is designed to store data for a 
long [lericxl of time. 

Well need to start by looking at the things that liappen 
when we start up our application. If the database already exists, 
that’s great and we don’t need to wony alioiit doing mtich 
more. If it dcK^sn't, we need to create it. 

But, how are we going to know what dataliase the user 
wants to use and wliere it might be? 

Tliere are at least a couple ways of dealing with tliis. One 
would lie to read a preference fi'ctm some rcfX)sitory like a 
preferences file and use tliat. The other would lx- to use a "well 
defined place" to store this. Ckmveniently on C^S X and 
Windows there is a con%^eniion for exactly this purpose. On OS 
X this is in the users Application Data directory And REALbask 
makes it easy to access. 

So let’s alter the App.Oj:)en event tt) handle ail this for us. 

// If the Application Data directory has a directory for 
our app 

// and iht> directory holds mt database tken we should use 
that one 

if SpecialFolder.ApplicationData.Child(app.kAppName),Exists 

= true ^ 

and 

SpacialFolder.ApplicationData.Child(app.kAppNameJ ♦Child (kDBN 


ame)♦Exists = true then 
app.db.DatahaseFtle = 

SpecialFoider.Applicatlonllata .Cliild(app.kAppName).Child(kDBN 

ame) 

app-db * new REALSQLDatabase 
app.db.tlaiabaseFil e = 

SpecialFolder♦ ApplicationData.Child(app.kAppName) .Child(kDBH 
emej 

// see ii we ran open the database 
if app,db.Connect 0 <> true then 
// oh oh something bad 

app.db = fill 

tnsgbox "Unable tu connect to database" 
return 
end if 
else 

U hum is there a dlren.ory for our application ? 
if 

SpecialFolder*Appl icati onData.Child(app.kAppName].Exists <> 
true then 

if no so Lfittor creaie one 

SpecialFoldertAppllcatlonData.Child (app. kAppNanie).CreateAsFo 
ldHr{) 

end If 

// is there a database 7 
■if 

SpecialPolder. AppllcatlonUau ♦Child [app - kAppKame). Child [app. 
app.kDBKame)♦Fxiars O true then 

// rio database file 

U create a new instance kEASOLDatabase Class 
app.db = new REALSQLDatabase 

// Get the file to the one in the users Library > 
Application Support 

app.db.DatabaseFile - 

SpecialFolder.ApplicatiouData.Child(app■kAppNaBie).Child(app. 
kUBNatne) 

// create the container database file 
if app.db.CreateDatabaseFileO <> true then 

ii sonethlng bad 
app.db = nil 
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msgbax "Jnable to create database" 

te-Larn 

else 

// ok so now create the database tables 
GreateDBTables() 

end if 

end if 
end if 

As you look this code over you should notice that Tve 
used two constants for the name of the directory, 
App.kAppName, and the name of the database, App^kDBName- 

Add a constant to the App instance in your project and 
name it kAppNanie. Set the value for it to MySttx'kApp. And 
add the second constant, kDBName, and set its value to 
“MyStocks-db*" 

You’ll also need lo create an empty method in the App 
instance called CreateDBTables. 

Well fill this one in later. 

If you run the app at this point you should find things still 
work, [)ul yt>u are no longer prompted U) select a database. 
Instead one is automatically place in -/Lilirary/Application 
Suppori/MyStockApp called MyStocks.db. 

This is exactly as it should be. 

This new damlyase is compictcly empty though. It doesn’t 
even have the tables we need and tliis is what well fix in the 
new CreateDBtables method. 

Bui how to get the same definitions w'e came up with 
ixTore? It turns out dial OS X includes sqlitc and wc can 
actually get it to dump out all the SQL well need to create the 
database. Open Terminahapp (located in 

/ApplicaLions/lJtilities) and type in 

sqlttel 

and then drag the ckitahase into the terminal window; sqlite 
w'ill open the database and then you can run the one SQL 
command needed 

select sql from sqlite.master where type = 'table* 

In my case diis gives me die exact sql 1 need to create the 
tables 

CREATE TABLE StocksOfInterest[Name Varchar. Symbol VarChar) 
CREATE TABLE StOckQuote(Symbol Text, Price Double, 
quoteUateTime Timestamp) 

1 can lake diis and incorporate it into die CreateDBTables 
method as follows: 

app. ^Ib.sqlexecuteC''CREATE TABLE StocksOf Interest (Name 
Varchar. Symbol VarChar)") 

app.db.sqlexecute("CREATE TABLE StockQuote(Symbol Text, 
Price Double, quoteDateTime Timestamp) 

Note that w^hat we have is one language, llEALbasic, telling 
anodier tool, si[liie, to execuie a command in it’s language, SQL, 
that it understands and can do something useful with. 


REALbasic does not know' anything about SQL. It’s just 
strings of characters to RHALliasic. 

And SQL knows nothing about REALbasic and it’s 
variables, mediods, or anything else. 

Tliis is very important to realize that they know nothing 
about each odier and that getting them to work properly 
together is sometimes and exercise in making sure the string 
yonVe created in your REALbasic' code IS the right SQL. 
Somedmes testing things out fiy liand is die only gcxjd way tti 
figure out wiiere your error is if you have trouble. This makes 
the inclusion of sqlite very handy on OS X, 

In fact, let’s test this out. If you have a database in 
-/Lilirary/Application Supfxirl/MyStockApp then delete it and 
Rin the program again. Once it has run, quit and then, in 
Terminal, ahave sqlite3 ope nthe newly created database. 

Again use tfie s<il cotnmand 

select sql from sqlltcjaiascer where type = 'table^ 

and you should see that iliere are die two commands that 
we tiad in our a p plica lion to create the tables. We’ve now 
created the tables programmatically. 

Moving On 

Now that we have created the database lets see how we 
can get quotes into it in an automated way, 

1 happen to like using YahiX) because the service is easy 
to grab data from. That said you can probably use whatever 
service you want, Some will Ix" easier and .some more difficult. 

What wo need lo know' \s how to get Ihe “current" <|uote 
from Yalux) for a specific slock in a form we can do soinelliing 
useful with. 

Yahoo has a nice simple IfRl, for this exact thing 
http://down load.fi nan ce.y a hoo. com/d/quotes.csv?^d 1 d I tl cl o 
hg v&e^. csv&s™<sy?n bol> 

In a browser if you replace <symbol> with AAPL this will 
download a file to your machine that is a csv delimied text file 
with the most recent c^uoie for AA1*L. You can alter a numiier 
of other attributes to get other data hut this is the form we want. 

So w^hat we need to do is get RKALbasic to go to this IIRL, 
gel die data and parse it apart and fiui ii in our database and 
die redisplay die data. And to do tliLs every “once in a whileL 
Nodiing to it :) 

It turns out that RRALbasic has jusi the diing for this task: 
the IITIT socket. There are tv^'o ways to use this; 
.synchronously and asynchronously. The simpler of the two is 
synchronously and so that’s whai we'll ase. 

Rut how to get REALbasic to do this “once in a while’? 
Again, REALbasic has a nice object called a Timer that can be 
used to do things periodically. Note that timei's are “patient” in 
lim they tty to work as close to die timing you set but if 
something else is really busy dicy will wait until there is a 
chance for tliem to do their thing. So they are reasonably 
accurate in running periodically but nor 100% precise. 

We’ll make use of the timer as it is good enough for w'hat 
we need. 
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Of)cn lliL^ wSicjcLs window and scroll down the list of 
controls, selea the timer, and drag one onto the workspace. 



Figure 1 - Selecting the timer 
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Figure 2 - Timer placed on Workspace 


A timer has several useful properties that we will want to 
adjust. 
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Figure 5 - Timer Properties 

The Mode property controls whether the timer is on and 
active or not and if it is one whether the timer runs and 
performs its action once, or repeatedly. You can toggle this 
setting in your prognim as well as setting it directly in the IDE. 

'iTie other setting is the Period, or minimum lime Ixrtween 
the timer performing its action. If the Timer Ls set to run its 
action multiple limes this will lx? the minimum time Ix^tween 
actioas. Careful thought as the period is specified in milliseconds 
and the setting shown above is only 1 scrond. Wc should set this 
to something more like 300,000, which is every 5 minutes. 

Let's make a methtxl that gets the stock data from the web 
and insens into the database first. 

Open the Ap[> instance and create a new method called 
GetStockPrice. This should take one parameter; the Symbol of 
the stock we want the quote for Mine Icxiks like 

Sub GistStockPrIce(s/mhol as string) 


dial HTTP aa HTTPSocket 
dial data as string 

If trim (symbol) = thm return 

ff we're Roing to grab the price fiom Yuboo 
fi the m, 1® Uke 
if 

http://download.rinance.yahoo.rom/d/quotes.csvTf^slldltIclohg 
v&e^.csv^s=<syTiibol> 
di® url as string - 

•‘htirp: f /download. finance. yahoo. com/d/quotha. c s v? f=sl 1 d 1 1 let oh 
gvSiG”. csv&s=" + syiibul 

// make a new liTfP tiockei In uao 
http “ new HTTPSocket 

// tell it rn get the data and wait no more than 30 seconds 
for a reply 

data = HTTP.Get(url, 30) 

// the data we get back la like 
// ••AAPL".117.05."8/l6/2OO7-,'*4:00pitt% 

2.85.116.91,118.50,111.$2.&6667fi28 

// pull out the price It hr noccond field) 

dim fitotkPrice as double “ val(ntbfleld{data.",“. 2) } 

// and use our already existing method to put it in 'Jje 
daiabaae 

app.AddDataforStock Symbol, stockPrice , new Date 
Rnd Sub 
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GetStockfricet-MPl") 


Now if you double click the 'timer we on iKld the code 
that will grab the stcK'k quotes every time die timer runs its 
Action. In the timer simply [)ut 

App*CetStockPrlcc("WPL'') 


This will grab the new quotes for AAPL every 5 minutes. 
But we also want to update the display with thcjse. And 
eventually we want to he able to make this grab a list of stocks, 
not just one or two. 

First lei’s deal with displaying the strKk quotes. 

If you look in the open event for the listtiox that shows tlie 
stock quotes it has a bunch of c:ode already that we just need 
to move somewhere else so we can have it redisplay things on 
demand, not just when the window opens, lliis is a perfect 
op|x>n:unity to refaaor this code so it’s more generally useful 

Start by creating a new method called HeDlsplayData. 

Take all tlie ctxle from the Open Event of the listbox and 
move it into this new method. YoiiT have to c:hange every place 
it says *'me.” to istSfocks.” 

Then, in the Listbox open event simply have it call 
ReDLsjdayData so it looks like 

Redlspl^yDataO 

And add a call to RedisplayDaUi at the end of the timer's 
actions as well so it looks like 



BLUE CRAB 
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etc. 
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SMS Text Message (mobile phone) re¬ 
minders straight from your menu bar, 
from any application! Never forget any¬ 
thing ever again. 
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RediijplayDataf) 


If you am now you should sec the display get a new' entry 
for AAPL every fevt^ minutes. However, the display of the stock 
prix:e might kx>k a little odd. On mine, as of this writing it 
shows "9.74t)00000056e+r. 

So lets change Retlisplay data a little. 

If you lcx>k at tlie line tliat reads 

IstStotrks.Cell(IstStockfl.Lastindex,2) ** 
rs.Field{"Price"].StringVaiue 


and change it to 

lBtSrocks.Cell(lsTStcck$.LastlTidex,2) " 
Format(rs.Field(“Price"}.DoableValue,"#,00") 


This w'ill make things kxik right. The original line just used 
an implicit convet'sion of a floating point double to a string. The 
default is to give you scientific notation, Tlie FORMA!' 
eonimand gives us control over how tiie conversion to a siring 
ocairs and so it Ux^ks Ix-tter. 

Lots of Progress 

Jiisi in this short sjirim we’ve made a lot of progress. WeVe 
mtide tlie applicatitin create it’s own database if none existed. 
We’ve added the ability to periodically grab new quotes from 
the internet and retlisplay them. And, when you quit and restart 
your application it will start up with all the data you had Ixffore. 
Not bad for this time around. 

ITiere are some things you might want to look into until 
next time, 

ReDisplayData just keeps adding to tlie list shown all the 
time and so if you leave this application running for a long time 
it w!li eventually have an enormously long list of ItenLs 
displayed. You might see if you can chnage that. 

And for the really adventurous, see if you can change JUS'l 
the SQL that Re Display Data uses so it only grabs the latest 
()iioie instead of all of them. 
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Packaging for Distribution 

Building Installer packages for software distribution 


By Greg Neagle, MacEnterprise.org 


I. 



MacEnterprise.org 

Mac OS X enterprise deployment project 


Packing things up 

Previously in MacTech, we looked at modifying Pirefox in 
order to implement custom default preferences. This iovolvecJ 
modifying several files inside rhe application bundle. If you 
made similar mt>diricaiions kyr your environment, you'd tlien l>e 
faced with the next task; distributing the modified application 
to all your managed machines. 

[here are many ways to distrilMite software to Mac OS X 
machines, but most c'ornmercial products — A[iple's and third- 
parlies' — rely on Apple Installer packages to install and 
update software, This can l^e a convenient approach when the 
software you want to distribute is already packaged in that 
format, but you’ll find tlicre are several situations in which you 
need to create your owm Installer packages: 

1. The software ts not dislril>uted in Apple package format 
[)y the vendor, and your software distribution 
mechanism does not suppon the alternate format. 

2. The vendt>r uses the Apple package fonnai but tlie 
package will not install witliDut user input - or, stated a 
different way, the package cimnot be installed ''silenily''. 

3. You need to make changes in ilie files iliai are 
distributed, or distribute additional files. 

4. You have internally-developed software that must lx* 
distributed. If ynuTe lucky, your internal developer will 
package it for you* If youH^ not lucky, or you are the 
developer, then you need to do it. 

Therefore, packaging software for distribution is a 
commtm task for OS X adminisirators. rorumately, there are a 
lot of available tools to help you with this task. 

Packaging Tools 

A partial and by no means complete list of packaging and 
related tools for OS X in no particular order: 


PackageMaker 

http: / / WWW. apple, com/support/downioads/serveradmintools 1 
055*htrnl 

This is Apple’s utility for tieaiing packages. It is available 
as part of the Xcode Ttxils, and also Lncludcd with the Server 
Admin Tools. It ciui create every package format supported by 
Apple: old-style bundle packages, new-siylc flat packages, 
metapackages, distribution packages, and hybrid packages that 
wt3rk on multiple OS versit>ns* Tlte link alx)ve is for the 10.5.5 
release of the Server Admin Tools; there may well he a newer 
release by the time this article a*aches prinu 

Pros: PackageMaker is a supported Apple tool and is free. 
Many of the otlier Uk>1s rely on PackageMaker tor at least some 
of their functio^alit\^ 

Cons: Ifs hard to use, and had a hislor>' of buggv^ releases. 
Iceberg 

htfp://s.siidre.free.fr/Software/lceberg.hfml 

feetx^rg is freeware by Sie[>lian Sudre, licensed with a BSD- 
style license. Ca[)able and weli-dcx^umented, Iceberg is very 
popular among Mac OS X administrators. It can trreale packages 
and metapackages, Inn not the newer distribution packages 
and Hat pat:kagL‘s. 

Pros; Easy to use and free. It supports creation of packages 
from filesystem snapshots, as well as manual assembly of 
package cT>ntenls, 

Cons: IcclxTg's installer installs a Startup!tern that launches 
an always-on background task* This makes some admins 
uncomfonable, 

LANrev InstallEase 

hMp://www*lanr€v.com/sobHons/insta!!ease.shtml 

LANrev, the maker of a cross-platform system management 
tool, recently made dieir InstallEase package creation utiliiy 
freely available. 

Pros: Ease of use, the ability to export Icelierg project files, 
and the tTeaLit>n of ‘Tininstair packages - packages that will 
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uninstall software installed by another packa^^e. Creation of 
packages from filesystem snapshots. 

Cons: It does not work standalone, 'lb actually create 
packages, you must have Apple's PackageMaker and/or Iceberg 
installed as well, 

Casper Composer SE 

http://www. jamfeoflware.com/products/composer.php 

Composer is a $100 uiilily from JAMP Software. Part of the 
Casper Suite of OS X client management tools. Composer is also 
available separately. Gisper Comptxstrr creates packages based 
on filesystem snapshots. When used with the Casper suite, it 
can create installation packages with extra abilities such as 
installing default preferences into users' home directoric*s. 

Pros: Easy to use. CKK)d dttcumentatioic 
Cons: fi's not frt'e. Casper Composer requires Apple's 
PackageMaker to build standard Apple packages. CoTfipK>sLT's 
special package features work only with other tools in the 
Casper Suite. 


Launch InsrallPase, 
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Click Start tcj liegin. Yt>u may optionally check No longer 
show this screen u> ,skip the introduction in the future. 


Helpful tools; 
logOen 

http://wwwJsa. umich.edu/lsait/adm in/mac/software/mdex.asp 
logGen is freeware from the University of Michigitn, by Pliil 
Holland and Dave l\igh. It is a amimanddine utility tor finding 
filesystem c:hanges. Yt>u could use it as |>art of a jxickage 
creation workilow together with pkgGen (described l>elow) 
and PackageMakei'. 







n tANm hfi«aiu«* 

f« chooii Msuttfid 
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pkgGen 

ht!p://blogarisink.com/?p=) 06 

This is a script by Zack Smith that parses the output of 
logGen and creates a "fauxroot” directory containing ail the files 
and directories found 1>y logGen. This fatixroot directory can 
then l:>e used by PackageMaker or k elierg lt» create an Installer 
package. The workflow would IcHjk sometliiiig like: 

* Run logGen to create a “liefore" snapsliot. 

* Install and configure software. 

* Run logGen to create an “after" snapshot and differences 
lisL 

* Edit the differences list to remove unwanted items. 

* Run pkgGen with the edited difference li,st to create a 
fauxro<it directory with c*opics of all needed files and 
dlR'ctories. 

* Run PackageMaker and use the fauxrtx)! direiiory to create 
your package. 

Example Packaging Workilow 

Let's use one of the tools to build an tnslaliation package 
for our mtxiifjed Fiadbx. I’ll use LANrev InstallEase for this 
example. 

We’ll start l>y assuming you already have an appropriately 
modified version of Fire fox on your system, and have 
downloaded and adivated a copy of InsiallEase from LANrev's 
website. 





.Since the Kindbx aj^pliaition is self-contained vvitltin its 
own application bundle, we can sjive a lit inch of time and 
create die package manually. You can do this any time you 
already know whic h files and folders you need. Select Manually 
and click Continue. 






OdM 



f_.'Eftlrt 


Ignore the c'onfusing messages alxiut snapshots; by 
chtxistng to cremate a package manually, you skipped the 
snapslicH process. You are now' looking ai an empty package. 
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Add the Fireibx application in llie package by simply dnigging 
it in from the Finder: 



START 

FAKING! 
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faxes directly by email 
as PDF file attachments. 


Corporate accounts from 
3 to 100* users available 


For more information 
and a special offer for 
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mm:MaxEniaii:coiii/MaGTech 





(^j^emair 


Call: 800-964-2793 




Snac^shot Data 



After dropping Firefox into lasiallFase's window, it sliould 
look like this: 



CtiKii :l 


You ciin exanrine the c( intents of tlie Firetbx app bundle if 
you'd like, and make clianges to the owner, group, anti 
pennissions t)f all the included files and folders if you wish. 
When you are satisfied, click Continue. 
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You have several options, and they arc not exclusive - you 
can select as many as you warn. 

• Apple Installer (-pkg): Tliis is the defauli. Yoiril need 
Apple’s PaekageMaker utility installed in use this. 

• llntnslaller package for Apple Installer (,pkg): this Is an 
intersting feature of InsuillEase. It uses the installation 
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packii^e information to create a special package ll»al 
contains a p<jst-in.stall script that removes ilie files and 
folders defined in the package. Yt>iJ can then use any 
software distribution system that relies on Apple's Installer 
(or command-line installer tool) to remove st^fiware as well 

• IcelKTg project (.packproj): Creates a project file for u.se 
with Icel^erg. This allow.s you to use Icebeig to edit 
package options Ixjfoa" creating the actual package, 

* Disk image with added flies and folders (.dmg): this is 
mostly useful for use w ith LANrev's other Ux)ls - it creates 
a disk image that .simply contain.s all the files and folders 
you've added to the package. 

For this sample workflow, all we need and want is a 
standard Apple Installer package, so click Create,... You’ll l)e 
asked where to save the package and for a filename. In most 
OSes, youll l)e asked to authenticate as an administrator. After 
a few moments, you should see soiueihing like this: 


The 'MyCustomFirefoK.pkg' Is now ready. 

Create Additional Package ^ { Qoit T 


You are done with this simple example and now have a 
package that will install your cusuan version of Firefox. 

Note that you had no chance to specify' any package 
options, like wheiher lir not the package requires a restart or il 
ilie package ciin be installed only on the slailup disk, if you 
need to specify atkliiional opijons, you are probably better ofl 
.saving an Iceberg project and Ihiishing your editing in Icelx*tg 
before creating ilte final package. 

Another Example 

Let's do a slightly more complicated exuiitple^ this time 
using filesystem snapshots. Again we ll use InstallFa.se, but the 
prexess is .similar in Icelxrg and Casper tx^mposen 

launch Installlaise and .select Automatically as the package 
creation method. 
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Click Continue. 


WWW.MACTECH.COM 


















Free Parallels Desktop 
after rebate and more! 


FREE 

UPS Shipping! 

6 Months Same as Cash! 

fflfer wo/iti fcr purdiflJBJOkW 

Up to ^250 Cash Back! 

On Apo(ea}trif>imt After maif-in ifdfats. 

FREE Parallels Desktop! 

AfiETmoil-OTfiiate wftfi pwEftcise ofmAppie€ompuier. 

FREE Epson Printer! 

ofo;TAppJie*a?mpuEer. 

Cafffcr'oiateori Sofkn. 


15" MacBook” Pro 2.4GHz 

FREC Paralleis Desktop!' tiEL Epson Printer!' 

original price ^1994 - 

^1449^ - ^100 mail-in rebate = 

^Aft^maiNn rebate. Califordetails. 


#7691239 


SAVE * 5 ^ II 

13" MacBook" Air 1,6GHz 
80G8 Hard Drive 
FREr Parallels Desktop!' 
FREL Epson Printer!' 
original pfke '1794 

‘1299'^^! 

U73750BS *After mallAn rebate. 


SAVE MOO! 

15" MacBook Pro 2.4GHz 
9600M SuperDrive 
-'~E== Parallels Desktop! 
.“REE Epson Printer!' 


ITBLaCie Big Disk 
Extreme+ USB 2.0, 
FireWire 800 and 
FireWire 400 Hard Drive 


13" MacBook'2GHz 
SuperDrive' 

REE Parallels Desktop!' 
Epson Printer!' 


Microsoft Office 2008 
fortheMac Student 
and Teacher Edition 

list price '149” 

'42M-'1S=^ 708^1 

ff73S2258 *Afier'f5mtarnrebate. 
HURRYfOfferends m(m. 


■: r 

47634013 *Afierfmihln rebate 


m4-'^10Q= 

47684020 ‘^After raail-fn rebate. 


Source code: MACTECH 


V Authorized Reseller 


Your^l Apple Superstore! 

Call 1-877-233-2B38 or visit macmall.com 




aim 





Excliidt checked files below In snapshots: j ^] 
Exclude 

^ RIe name matches DS^Stoi'c’' 

Fite name matches ‘'.FBClndex’' 

M File name matches *.FBCLockFoldef'' 

M File name matches ".FBCSeimaphoreFlie' 

M File name matches * bash_hi$t0rv‘‘ 

M File name matches ‘^.hotfiles.btree** 

File name matches '^AppieSharePDS*’ 

File name matches TheckForOSX** 

^ File name matches "Desktop OBT 

^ . n ^ n»n <ivi^»^frnsr fSC" 


( Cancel ) 


Choose the source for the snapshot. In almasi every cise it 
will be the startup disk. In this examplcj the startup disk ts 
named ‘‘Leopard”. Install Ease by default ignoa^s a lot of items 
on the disk wlten making .snapshots to reduce the numlx:r of 
false ptjsitives. You can view and edit the lisi of excluded items 
by clicking tlie Adjust File Filter*** button. 


Ear this example, we‘11 leave everything at the default 
settings. Click OK to dismiss llie exclusion editor, and click 
Take Snapshot to stan the "fxTore” snapshot. 


Taking a snapshot of leopard'. 

i r.tTi I KUPM'I'I fmm 111. Bii 1 1 jagiffltAi} ( Cancel ) 

/Useri/.gneaglc 



You1l w'aii seveml minutes as InstallEase scans the disk and 
records information about existing filesystem items. Note that it 
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wjLs scanning my FileVault-pmtected home dirmory at the package. Launch /Applications/TextWrangler,app, 

montent I took the screenshoL More on tliai in a bit. When it’s and you shoiiid see this: 

done scanning the disk, you1l see this: 


.... . _ . , ---- 
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Now it's time to install your software. For lliis exain[]le, 
well install TexrWrangler 2.3- Normally this is a drag-and-drop 
install, and so would need to be repackaged tc* be able to be 
pushcxl out %viih ARi) or most other iastallaiion methods. 

[ O _j ^TextWrangfer ^,3 _ 

X _2 Itgms, 3.S MB svAil^te 


BARE BONES 

TExrWBAlf^LIH INSTAlIAtlOtf Dl&r 


Drag iht? ..Op^n ttw 

k&n ta (he AfipHutlkMtt fokkf 

fotciCT. 4nd ru«t f ext Wr4iK4t«f. 



Te*twrang(«r ApplicAilons 


Download ilic TexiWrangler 2.3 disk image from Bare 
Bones’ website and open the disk image, install the app hy 
dragging it to the Applications fctlder, aiiiliemicating as an 
admin when ret|uesied. 

If you wert^ to package lextWrangler now, you’d have a 
working application, hut you’d \:>c missing the command line 
tools that come with the application. Worse, wlien your users 
launched TexiWrangler for the first time, tliey'd lx? asked for an 
admin password in order to instaii the coniinanci line tcKils. To 
prevent that, well do it in advance and add it to the installation 


\n order to insiall the command Une toots. 

Type an administrators name and password 
to attow TextWrangter to make changes. 

Name || j 

Password: 

Details 

@ ( Cancel ) 

Audientiaite as an administraior, then t|uii TextWrangier. 
Now we t'tm return to InsiallEase and click Take Snapshot. 
After Install Ease scans the di.sk ft>r changes, you should see 
.sometliing like lliis: 






I've turned down mo.st o\' tljc disclosure triangles so you 
can see what InsiallEase lias found. Note that it found not 
only the main Text Wrangler application in the Applications 
folder, but found the command line tool 
(/usr/bin/edit) and its man page. Without a snap.shol 
utility, it might have lieen difficult to determine what iteim 
were actually installed wlien the command line tools were 
added. 

Well want to make a few changes before proceeding. 
First, Tn.siallEase found changes in my home directory. 
Unfortunately, since I have a File Van It protected home 
directory, all it found was a changed 
**gneagle.sparseimage\ so I donl know' exactly what 
changed, but Fm fairly certain I dtm’l care, so Fm going to 
remove /Users and evcryt.h»ng below it. 

You may Ixf tempted to edit the exclusion list to always 
exclude /Users. Resist that temptation. Some software 
installs items in /Users/Shared which youll want to 
capture. Also, it might be useful to see what files are created 
in a user’s home directory on the first launcli of an 
application. (In which citse, using an account with a 
EileVault-protected home directory to install that software is 
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Welcome to Cerro Azul Coffee 


Photofont WebReady allows you to enhance your web pages ® 
with custom fonts of your choice in a search engine friendly, 
standards-compliant way. With Photofont WebReady, you can 
convert any photofont, OpenType font or TrueType font into an 
embedded web font. The web font is then rendered on your 
web page using Flash* technology, yet keeping all the advantages @ 
of standard hypertext. Your visitors see the page the way you 
want them to see it. 

Learn more about Photofont WebReady and photofonts at 
http://w w w.p hotof ont.com/photof ont/webready/ 


The main title <HI> has been converted to a 
photofont to better match the desired look and 
feel of the site. With photofonts designers can 
take advantage of gradients, transparency, 
shadows and more! 

Until now, web designers had to settle for Arial, 
Georgia or some other "safe" font to make sure 
the overall design of the page looked 
consistent With Photofont WebReady 
designers can use the most suitable font for 
each project. 
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probably a bad idea.) Ytm probaldy won’t want to include 
user files in an installarion package, bur you may need to 
manage them some other way or at least be aware of iheni. 

'Fhere's another change to make l)cfore wc build the 
package. Note that the TextWrangler application is owned by 
gneagle, Tliat won’t prevent TextWrangler for working on 
other systems, but it really would be better if we set ilie 
ownership to root or a local admin account to match other 
installed applications. 


every included item individually, which quickly gets tedious, 
Unforttmately, there seems to Ik* no easy way to propagate 
elianges recursively. We can now' click Continue and choose 
our package fonnats and create the package just like in the first 
example. 
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TextWrangler?, 3.p kg 
Packing it in 

No matter wiiat icK>i you use, the basic concepts behind 
creating installalittn packages for OS X are die same. Different 
tools have different options and abilities - you may need to 
experiment with a few to find the ones ihat meet your needs. 

WW 
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Here are the c hanges completed: the /Users folder and 
its contents have been removed, and the owneisbij) of 
TextWrangler lias been changed to root. Note that 
TextWrangler is actually an application bundle, so you actually 
have to expand the contents and change the ownership of 
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engineer at a large animation studh, Greg has been working mrit the 
Mac sme 1984^ and mth OS X since its release. He can be reached 
at gregneagle@macxom. 
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GPS and Your Photos 


How location-based data in your photos 
can help you organize them 



by Norbert M. Doerner 


:y 


GPS inside photos? 

You surely kntm ihiM GPS (Global Positioning* System) am 
lx? used to navigate your air through the maze of streets, hut it 
might be surprising to hair of GPS in amncction to your growing 
digital photo collation. But if you travel a lot, and take photas at 
any locations artiund the world, it Ls very helpful to atiiially know 
precisely tuhetv that phott) was taken. Take a look ai figure 1 and 
tell me what kxati<)n il shows! I still remenilx^r that now, I'tecause 
it is a sfx^claeular view in western Ireland, hut other pliotos might 
not lie so obvious to [yhee, and in a few years, I niighi have also 
foigotten the details alxiiit this place as welL Tliis article explains 
all the steps in the workflow of adding and niiuiaging GPS data 
in ytiur photos, and shows you what tocils ate available on the 
Mac CO help you with that ta.sk. 



Figure 1. Where on Earth was this photo taken? 


EXIF, IPTC, and GPS 

Any picture you take with your digital aitnera automatically 
receives a whole nsei of useful such as tlie P-Stop, 

afK^rture, ex[x>sure time, the focal lengtli used to take the photo, 
the name of your oimera, and the exiid date and lime, among 
others, 'iTiis infonruition is stored in die EXIF section of the file, 


and iliat is also tlie jilace for the GPS data, consisting of die 
longitude, the latitude, and even altitude values. 

Anodier useful section of metadata in a photo tile is the 
optional TPTC part, wliich contains textual informaiion, such as a 
caption, Iteadline, keywords, and aipyright. Ihe IPTC recoid also 
includes the city, state, and country, but all ihc'se fields usually 
have to be entered manually. You can do dial in Adobe Bridge or 
Photoshop, and is certainly helps finding your files already. 

Figure 2 shows lioih EXIF and \FVC fields of a lypic^al photo, 
seen here in the CDFinder Inspector. Tlie sample file contains 
GPS tags in the EXIF .section, as well as .several fields of textual 
inlbntiatioii in the IP'IG part, such as die caption. 
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Figure 2. EXIF and IP1C metadata of a photo 

Is il tagge(i already? 

'Ihe Finder doesn't indicate whether a file contains 
emlxxlded GPS tag data or not. But Preview.app at least shows 
die geographic coordinates in its Inspector window; in Lcojiard 
that window even has a small map for lx:iier visualization, though 
you first have to open die file in Preview to see all tfuu. 

A much quicker way uses GPfi-Infb CMM, a free* contextual 
menu extension lor the Finrler. If a photo has emliedded GP^i 
tags, this plug-in displays the geographic ax>rdinates directly in 
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che context menu, ils shown in figure 3. But the numeriail values 
arc just a first indication- most (x;of)le worVl Really know where 
on Earth this place actually is* 

The cle-facto standard in ge<^raphic visualiziition is surely 
Google Earth* a fiee api)licatiun that displays a world globe, and 
allows ytHi to yxxm down to the street level, using pliutos taken 
from Siitellites or airplanes to display the entire planet. 

'I'he GPS-lnfo [:)lug-tn is able lo talk ro Grx>gle Earth, by 
using a mighty submenu widi plenty of ttx>ls to w^>rk with the 
ccKrrdinates. fi can reveal the location w^here the j>lu>U) was 
taken in Google Barth, even launching the application, if 
necessary. Hut it can also show photos that were taken at this 
spot in the photo portals Panoraniio, Flickr, and SinugMug. 
Also, it offers direct access tf> Google Maps* MapQuest, and die 
WikiMapb service* And if that is not enough, yt)u can even 
extend that submenu w'ith your own LiKLs by adding them to 
the GPS p strings fife inside the GPS-lnfo bundle. 



Figure 3. CPS-lnfo shows a geolocation directly 
in the Finder 


And .since this is MacTech, you can whet your fingers 
now and add a nice new web service to GPS-lnfo CMM 
yourself! Open the bundle of GPS-lnfo CMM, located in 
-/Library/Contextual Menu Items/, and dien open 
the file GPS. strings wil!i your favorite text editor, TextEdit 
will do fine* 

Geocac^hing is the modern day treasure liuni for atlults, 
where a cache of funny or silly items has to be found widi a 
GPS unit and hints left on wef>site*s. We want to add the 
ability to find any geocaches located near our selected photo. 
To do that, simply add the following two lines at tlie bottom 
of the file: 

Listing 1; GPS.strings 

"a?” = "geocaching.com’; 

-b?-* - 

“http: //WWW. geocecbing.com^roap/default 


It is possible that you need to u.se a dirferenl number 
instead of 7 as the index in both lines, depending cm how 
many other entries are already contained in that file* The first 
line is the *srring that will appear in the menu, the second line 
the URL that will be loadt^d. The %f will be replaced with the 
actual coordinate values, ju.sl like in a print f statement. 
Now' .save the file and log out, as contextual menu plug-ins 
will only load into the Finder when it is launched. Then select 
the context menu of a gcoiaggcd phoro^ and tn the GPS-lnfo 
submenu, you will see a new entry named geocaching.com. 
Selecting it will open the website and shows you the 
geocaches available next to the GPS position embedded in 
the photo file. 

Getting GPS data into a photo 

There are three ways to add GPS infonnation u> an image 
file* The first is to manually add it, with the help of a map and 
some software. The second way uses a GPS logger to get a 
list of locations or tracks, and combines that with the actual 
photos. And die third is a new caimera that automatically does 
all the work for you, or a small device attached to an existing 
camera. 

For all your existing digital photographs, manually 
adding GPS tags is die only choice you have. FortunaTely, dial 
is not as hard as it sounds, tlianks to some nifty tool.s, such 
as the free Geotagger, written by Craig Stainton. It won't get 
any simpler: Launch Google Harth, select the position you 
want, and drag your pltoLos into Geotagger. I'hat is all! 
Geotagger will read the current location out of Google F.arth, 
and write ii into all photos. 

One little problem liere is that the main whndow of 
Gcxigle Harth can be quite large, and the current geographic 
location is at the exact center of the displayed ma[). A useful 
tool named crossliairs.kmz wnll place crosshairs at the exact 
center, making the tagging much easier and more precise. 

*Samewhat more elegant is the donation ware 
PhotoInfoEditor. !ls clean interface offers a built-in Google 
Map, and can tag a long list of pht>tos <iuickly, even witii 
different locations. PhotoInfoEditor gives you extra text fields 
where you can enter the IFLC description and comment into 
your pictures, and will also set the city, state, and country for 
you as well, One flaw in the workfiow is the insistence of 
PhotoInfoEditor to write the modified images to al! tiew files, 
radier than adding the tags to your exi.sting files. 

Probably the best w^orkflow uses the new^ Graphic 
Converter 6.2: d'he browser can read the currcni location out 
of Gotjgle Earth and quickly place it in all selected photos* 
Graphic Converter is also tlie only tool that writes the view 
direction, tilt, and distance into the photo as well. Since the 
browser of Graphic Converter badges all geotagged piiotos 
with the red Geolag Icon, you can quickly see which 
pictures you still need to process. Thai is a very smooth way 
to getitag your photos quickly* 


Mcnm 


CPS AND Your Photos 
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Figure 4. Graphic Converter has a powerful browser 
with geotagging support 


Use Tracks 

Better than manually lagging your photos is a semi 
automatic process tliat uses a tracks file- This is essentially a 
list of geographic locations with an exact dale and linie, 
simply recorded along your way at either fixed time intervals 
or after a certain distance traveled. If you have set the clock 
in your camera to the correct time, this makes it possihle to 
find out when you tcK)k whicii picture wbertK 


You can get a tracks file from many fiPS devices, 
including Garniin and TomTom navigation units. It is a good 
idea to check your existing navigation device to see if it t:an 
already record tracks along the way. 'to get that list of tracks 
out of the unit, you need either the software that comes with 
the unit, or a generic tool, such as LoadMyTracks, which 
supports a very large number of GPS devices. 

With LoadMyl'racks, you first transfer the tracks file to 
your Mac. Then yoti need software to find the coordinate for 
every photo and write it into the file, if your tracks file uses 
die common GPX format, you can use Graphic Converter for 
this, One potential problem liere is a lime offset. If the time 
in your camera wasn’t set correctly, Graphic Converter won‘I 
lx? able to match the jMOper coordinate value to your photos. 
In tiiat case, FhotoGFSHditor is a stjlution. Similar to 
PhotoInfoHdiior of the same developer, this clean application 
has a map, and offers to set a time offset to compensate for 
a mi.suligncd camera clock when matching GPX data. 
Unfortunately, PhotoGPSEditor also won't simply write the 
GPS data into your existing plioto files, but forces you to save 
the m<»dified photos into new files. 
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Figure 5. Match photos to a CPX tacks file, 
using PhotoGPSEditor 


A second useful free tool, GFSPhotoLinker, ol'fcni siiniliir 
fimdionality, but lacks a map. Instead, it directly changes the 
GPS and IITC values in all selected photos, making the 
workflow eitsier and quicker. 

While the GPX file format is widely supported now, you 
iiiiiy have tracks Hies in any number of other, older formats, 
such as NMIlA, TRK, or GPI. Tlie Swi.ss army knife for amvcning 
getKkita init) ;my format is GPSBahel, a cross-plaifbnn cotnniand 
line kK)l that has a Mac GLfl named GPSBalxd+. This also 
supports tlie UK)ru niodern KML file format tlial Google Harth 
has introduced, 

IF you don't already own a navigation unit, several small 
battery [x>weix-'d devices, called GPS logger or tracker, are 
available to track ccK>rdinaies, They are no larger than an 
antaent analog film cartridge, and include a l:)attery, Lite entire 
GPS retx'iver, and a memory chip that stores the tracks. 

No Mac software at all €t>mes with the affordable Holux m- 
241 logger, w^hich Is Qthen\4se a very nice unit, as it oflers a 
small display that makes it possible to show' sfTeed and distance 
even during the tracking. It also uses Bluetooth, so it c'an 
transfer GPS pt^siiions without a cable. Bui to gel the tracks to 
thc^ Mac, you neetl a very ugly Java 0 |>en source ap[>lication 
called bt747, wintli is (|uiie hard lo set up, though a very helpful 
guide is available t>nliiie. Once I Itad configured the software 
properly, I could quickly transfer tlic tracks to my Mae, and even 
convert I he ('oordinare list into several fomiats, such as GPX, 
KML, and NMEA,Much betier Mac support is available from 
GiS'lEQ tor their PhotoTrackr units. The smaJl Ptu>LoTrackr Lite 
is a bit larger than the lloiiix, and offers neither display itor 
Bluetooth, but the recrently inlrmluced Mac software is really 
usefi-il. It quickly loads tfie track data from die device, and writes 
the cfxirdinates into your photos. It even has basic allium 
fcaturus, exports ph(>m slide shows in Flash, and presents your 
images on a nice map. One huge problem, though, is the 
complete lack of support for RAW pliotos. Since mosl people 
initially using GPS iracking will l>e professional users, this 
missing feature is a real deal breaker for the softw^are. But once 
you have the GPX tracks file on your Mac, you can always use 
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Graphic Cx’jnverrer or PhoioGPSRdiior ui aliadi the ctK>rdinaiCfi 
lu your RAW photos as well 

Cameras with GPS 

As you Siiw, even the senii-ciutomatic geotagging with a GPS 
tnicker involves quite some work and planning. Wouldn't it fx! axjj 
if your camera could do all tluit for you totally automatically? 
Indeed, tltat would l>e very nice and the fiisx cameras with that 
option are actually available while you a^ad this. 

TIh; must p<>pular one certainly Is llie iPlione 3G, which lias 
GPS on lx)atd and automatically tags your photos wliile you take 
them, but the iPhone hits only 2 Megapixels, and is hardly a 
serious camera. Nikon jumps into the game with ihe new 0;Kjl()ix 
P6000, a eoniptcl digital camera widi 13-5 Megapixels and a GPS 
receiver built-in. Certainly, the next generatif>ns of SLR cameras will 
include GPS chips alreiKiy. 

If you alrt'ady own a SLR camera, you miglit l?e able to extend 
it with a GPS devic'e. Nikon was aware ol' the value of GPS for 
some ye;trs already, and liad added a serial port to a wide range 
of pR)fe.ssional SIR cameras, such as die D3, D7(Kl D3tK), D2XS, 
D2X, D2HS, and ilie D200. You c'an get full GPS features on these 
cameras widi a smxiU extra unit, such as die Dawntech di-GPS Pro, 
or die Solmera DP-GI^ N2, which will also work on a Fuji S5 Pro 
camera. Tliese units are attadied by a snuill cable, and can l>e 
mounted in die flash shex" or the camera lielt. Wheiicwr you rake 
a photo, the airrent GPS jxxsition will be written into the images 
file in.side the camera immediately. It really won’t gel any easier. 


For two Carton cmieras (FOS 400 and KOS-ID/Ds Mark TTl), 
Oawntech also offers a device, but tliai rLX|uires die radier 
expeasive Canon WFr“E2 or E3 (Wireless File Traasmitter) to be 
attached to tlic camera first. 



Figure 6. The Holux m-241 is a nice logger, 
but lacks Mac software 

Find more photos 

Adding GPS data to photos can be a lot of work, 
espedally for your existing photos, but it definitely is W'orih 
the effort. Once you can see your photo collection on a 



Look familiar? 


high impact plastic 
lifetime guarantee 
30 day money back! 

$13.99 


www.macmagsaver.com 







Your email program does 
not have one of these: 



Ours does. 


Imagine an email program that was smart 
enough to observe and learn how you handle 
your email. Like offering to reply to certain 
types of email messages using a response 
you've previously sent. Or giving you the 
option to auto-file a message you’ve read 
based on how you've filed similar messages in 
the past. What if you could defer a message 
from your inbox for a few days or weeks, so that 
it magically reappears later when you’re ready 
to deal with it? What if this program had an 
amazing junk mail filter that would leave your 
inbox devoid of spam? What if this program 
was as familiar and easy to use as Apple Mail? 


After three years in development, we've 
finally created that program. Outspring Mail 
is the newest email client for Macintosh, 
We've taken the best features of existing 
email programs and coupled them with our 
patent-pending intelligent functions to 
create a program that will make your email 
chores far easier. And since this is a 
current-generation application, it supports 
major email protocols including POP, IMAP, 
SMTP and SSL It also runs natively on the 
latest Macintosh computers and OS X 
Leopard. But don't just take our word for it. 
Check out the details at www.outspring.com. 


Outspring Mail. For those who take their email seriously. 
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world globe, or find photos taken near a certain spot, this 
work really pays off. And that is not alL 

Several digital asset management tools already display 
the embedded pkaire coordinates, Apemire sliuws the 
longiritde and latitude values in the Metadata section, but 
only alter you ex[)licitly enable these EXIF fields. A Ijiand 
new plug-in for Aperture is called Maperttire. This freeware 
di,splays the embedded getnags in a Google Map view, and 
offers you to write the coordinate into photos. It installs 
itself in the Edit with... context menu of Aperture, and is 
even able to handle multiple images at once, 

Adobe Lightrooni ji^st displays the geographic values, 
but has a simple ijotton to show the location tn a new' 
Google Map brow^ser page. Micrttsoft Expression Media can 
show a map window with a marker placed at the location f>f 
one selected photet. 

Even iPhoto displays the GPS coordinates in its lcitej?t 
version, but offers no more than that. The free plug-in 
iPhotoT<)GoogleEarth expands iPhoto, and allows you to 
export tmiltiple images into a KMZ file for Google Farth. 
This is a compressed version of the KML file, and contains 
photo thumbnails and optionally even the original photo 
files. After opening iliai KMZ file in Gtiogle Farth, you have 
a new layer wilh your photos placed on their proper 
geograpliic locations. As the KMZ file also includes the 
deseripiion you have eniered in iPhone this is a nice and 
quick way Co create a travel album ftrr Google Earth. 

With all your photo.s geotagged, it would make a lot of 
sense to project them onto a wtrrld globe, so you can see 
quickly where on earth the pictures originate, Ovolah 
Geoplioto is a commercial application [hat dcx.^s exactly tliat. 
Having your library presented in tliat way is an interesting 
experience, and a fun way lo browse rhrougli your photos. 
While Geophoto also ijffers the ability lo create and tipload 
Fliekr albums, and to add photos from Flickr queries to your 
libra 17 , the demo version is a bit annoying by trying to make 
you buy the software. 

The digital asset oianager CDFinder goes a step further 
with a unit|ue new Find option: Not only does the Inspector 
in CDFinder display the longitude, latitude, and even 
aliilude values, but it also finds other pliotos taken near die 
spot. Simply select a photo containing GPS data, and open 
the context menu. You will see a whole list of Find options; 
ime <jf them is lo find all [>hoto.s taken near that location. If 
y<ai choose this* a new w^indo%v will appear, Figure 7, 
showing you where the coordinates are localed on a small 
world map, and asking you for a distance. All you have to 
do is enter an appropriate value and hit OK. and CDFittder 
will display all f)hoios that you ever took near ihai [>lace, 
regardless of when tliey were taken, aiul where ihiy are 
sltwed in your disk lil>rary. ^riiai is a powerful addition to the 
already extensive Find features in CDFinder, and alstj tjffers 
a new way of browsing through your data. 


O _ CDFinde r_ 

Find all photos taken within 
S km of: 

N S2’ 10' 54,6", W 10^' 12' 27.2" 


Cancel ; { OK > 

Figure 7. CDFinder finds all photos taken near a place 

Additjonully, CDFinder offers liie same functioas in its GPS 
submenu ytxi know from GPS-Info* .suHi as to reve:il photo 
kx'aiitjn in Google Fiirlli, Google Maps, WikiMapia, and many 
more. You can also extend CDFinder to support more GPS web 
.Servian'S, the same way we did with the Gl^lntb CMM. And if you 
select mcjrc than one Ok* at once, the exptin lo a KML file makes 
that II ni% way to get a wdiole bunch of axjidinates <|uickly into 
Google femh. 

More GPS tools and web pages 

In the previous .sections, we have relied mostly on Google 
Fanil <jr Cnjogle Majxs to finwide tlie aoiial map data. While these 
ane lkx.‘ for personal use. any commercial applieiition may need a 
suitable license to operate on them. One allemative Is 
0|x^nSireeiMap, a amipkiely tree m;ip of the entiR" world that is 
being built by a>unile,ss volunteefs. While some world areas 
[iiighi not be covered completely yet, the work is ongoing and 
includes mom roads and [jiaces every day. And if you are 
intere,sted in it, you oan even .supply your own tracks and new 
street information to iinfirove the map. 

Anoiher valuable ,soitrc'e of geogntfihical inronuaiion is tht? 
Wikipediiu Every .single entry in this entytHojx^dia that descriix."s 
a place or location has it,s exact axrrdinates dispbyed in tlie top 
light corner of ihe ]>uge. If you t:lick on that, you will get an 
extensive li.sl of wh .services for this piirticular ctKirdinatc, 
including links to TerraScrvcT or mo.si map services in the wel>. 

The connetiion frean a .set of numerical c(K>rdinaie values to 
a place name or vice vensa miglil also be very lielplul, and the 
free web service geonames • org provides exactly that, CDFinder 
u,ses iliat service to match a place name, such as Golden Gate 
with the real C(K)[dinates, to enable the proper search for thai 
place in your filioto library. Geonames even supplies a list of 
Wiki|Kxlia articles connected to places near ifie specified kK:iition. 
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The Undiscovered Country 

With the mtrcxliiriion the fct Nikon compact cament wiih 
0 built-in GPS ehi[>, and tlie ninjor improve mentis of GPS related 
sSi)!'tware on tlie Mac recently, it is clear tliat geotagged photas will 
lx* iin everydiy user in the near fuRire. lire software tfX)ls still have 
a way to go, hut this article has given you a full Uk>1 lx.‘lt for all 
steps tjf tlie workflow, to successfully work witli geotagged 
photos, and to give you new ways of deafing with the ever- 
increiLsing ph()U) lif mines. 

Related Links 

Gee nagger: http: //era ig. slan ton. neL nz/soffware/Geotogger. html 
Crossliaiis for Google HiUth: 

http://crtiig.Stanton .net.nz/software/fites/crosshairs.kmz 
GPS-lnfo CMM: http://vww.cdfinderde/en/en/en/gpsinfo.html 
Gcx)gle Earth: http://earth.google.com/downlood-earth.html 
PhotoInfoHditor; 

http: //WWW. mmi software. co. u k/pages/photo i nfoedi tor. php 
PtxHoGPSEditor: 

http://www.mmisoftware.co.uk/pages/photogpseditor.php 
GPSPhotolinker: 

http://www.earlyinnovations.Gom/gpsphotolinkef/ 
OpenStreetMap: httptZ/viww.operistreefrnap.org/ 

Ciraphic Converter: http://wwwJemkesoft.com/ 

GPSBabel; http://www.gpsbabeLorg/ 


GiS'TFQ PhotoTrackr: 

http://www.gisteqxom/MACsoftwa retour, php 
1a xidMy J’rjcks: http: //www, cl uetru st.com/LoodM/Trocks. hfml 
I3t747 How^'To: http://www.trick77.eom/2008/07/l 2/how-to- 
holux-m-241 -with-bt747-vl 48-gps Jogger-software/ 

Solmeta DP-GPS N2: 

http: //www.solmeto.com/efi/piioduds_detQil.asp?id =^10 
r>awnlet:it di-GPS Pro: http://www.dawntedi.hk/di- 
GPS/pnoduds.htm 
iPhoto IbGoogle F-t rt h: 

h ttp: //craig. stonton. net. nz/softwam/i PbotoToGoogle Ea rth. html 
Ma pertii re: http: //www, u berm i nd .com/products/ma perlu re. ph p 
Geotag Icon Project: http://www. 9 eotogicons.com/ 

Geophoio: http://www.ovolab.com/geof^oto/ 

CDFinder: http: // y/ww. cdfi nder.de 
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The Road to Code 


by Dave Dribin 


fidJitiitWitiiLeftX: (float )leftX 

botconiY: (floot ) bottoraY 
rightX;(float)rightX 
topY^{float}LopY: 

(ilost)area; 


Play it Again, 

Sam 

A review of the last year 
> and a half 

In Review 

Over the bsi year and a half, we've covered a ItH of ground 
on The Road to Code. WeVe gone over the basics of 
programming in C lo advantYxl Cocoa technology, such as 
Cocoa bindings and Cure Data, ’Hiis months we're going to put 
all these concepts together in one article, for those who haven't 
read each and every article sinc:e the beginning of our journey 


- (float)perimeter: 

@end 

'llie @ interface keyword in the first line declares a new 
class named Rectangle whose superclass is RSObject. 
OI)jcclivc-C classes can only have one superclass, meaning 
multiple inheritance is not supported. The NSObject class is 
the rmt of all class hierarchies. 

Instance variables are declared between the curly braces, 
They are listed, one per line, with their tyjx' followed by their 
name, similar to structures in C. Instance variables are only 
available to the class iinpicmentation. 'they are generally not 
acces,sible by other classes. 

Instance methixls are how* others interact with your class 
and are declared until the @end keyword. Instance methotls 
have a bit of a strange syntax compared to C functions. Tlie 
return value is in parenthesis and ttich method argument has a | 
keyword before it. Tliese keyevords are actually part of the 
inethcxi name, .so the full inelluKl name, called a selector, for 
the first method in the Rectangle class is: 


Objective-C 

'lliere are three legs iliiit support Mae OS X programming, 
the first lx:ing Lite language. Programs are written tor Mac 05 
X using a language called Objeaive-C. Objective-C was ncJl 
created by Apple or even NeXT, Ixit NeXT adopted it in the 
mid-eighties. Since then, Ohjective-C has not l)een used by any 
other major vendor, thus it's mainly .seen as Apples language. 

Objective-C is a strict superset of the cross-platfomi C 
language that adds (^)jeci-orienied pretgramming. C is a 
static'aliy typed language, meaning every variable is declared as 
a sfK'cific type, like int or float. You still use these prirnilive 
types when coding in ObjectIve-C. Yon also still use C for basic 
control structures, such a,s if/then statements, and for and 
while loops. 

Objective-C adds objext-oriented programming cm top of 
Cs procedural model. Listing 1 shows Lite interface of a simple 
Ohjective-C class to ^present a getwitetric rectangle. 

Listing 1: Rectangle class interface 

xt ^ Foundation/Foun-1 i Lion, h> 

@imerfflce Kecitaiigla : NSObject 
I 

float 

float _bottoiiY: 
float _tfidth; 
float _height: 

I 


iniiWittiLef tX: bottoluY: rightX: ; 

’tlie arguments are interleaved wliere the coloas are. 
Calling meiluxis u.se the sejuare bracket syntax. For example, 
tins is liow you would ctill the area met fit k1 : 

float area “ [rectangle areal: 

For melhod,s with ai'guments, the iirgument values are 
interleaved with the keyw^ord part of the melliod. You can also 
chain multiple method calls together by nesting the square 
lirackeis. Tliis is how' you wmild call the consirucior to 
initialize a new Rectangle: 

Rectangle • rectangle = 

[[Rectanglti alloc] inltWithl^ftXiO 

bottomYiO 

ilghtX:5 

topYDO]; 

Tile use of inierleaved keywords Is unlike mtxst languages, 
[ml 1 think it makes inethexb much easier to read, 

Tlie minu.s sign in fmnt the meihtKJ name means it is an 
instance methcxl: you call this tnedKxl on an instance t>f the 
class. You c:an use a f^lus sign to declare a class metliod; 

+ (Rectangle •)5ier(jRent: 

lliis means you call die method on the class itself: 
Rectangle * rectangle * [Rectangle zeroReetJ: 
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lb define the Ixxiy of a niethfKl, you repeat tfie method 
signature and put the lx)dy of tlie method in curly braces; 

* (floal)iifeti 

f 

return ^vidth * _height; 

[ 

Tills is very much like standard C tunctiojis where you use 
the return keywonJ to stop execauing tlie method and set tlic 
return value* As tliis example sIkjws, you can directly access 
iaslance variables. 

Properties 

Objecrive-€ 2.0, which was introduced in Mac^ OS X 10.5, 
hut is also available for the iPhone SDK, kis a new Feature 
called properties. Propt*nies simplify the dtx'laring and 
defining of accessor methods iliai expt^e instance variables. 
Listing 2 is iiiir rectangle interface declared using properties. 

Li.sting 2: Rectangle interface with 

f M*operties 

import (Foimdfltion /Foundjat 1 on. h> 

#int«jrfae^ Rectang^le : NSObject <NSCodiQg> 

I 

float ^leftX: 
float _bottomY: 
float width: 
float _beight: 

[ 

(?propt‘rty Tloa' leftX: 

J*?property float bottoroV; 

#propRriy fIdat width; 

^property float bplght: 

Spropofly (readonly} t'iofl: area; 

^property (readonly! floa- porimetar; 

- (id)initWitbleftX: {f loo'JleftX 

bottomY: (floa’J bottomY 
righLXtCrifja'lrlahtX 
topY:(fioat)topYi 

The @ property keyword is used to define a properly. 
Not only does this autoiiiatiolly declare the getter and setter 
acces.sr.>r methods, liut it also means that ilrcy may he accessed 
using dot notation, instead of merhtxl call notation: 

flgflx area * rectangle.area: 

You Still need to define the Ixxly of iliese implied gener 
and setter methtjds, but these ni;iy also be generated u.sing ilie 
(^synthesize keywtjrd; 

%yriLli4*sizi? leftX ^ . ieftX; 

bottomY = JjottoroY: 

^synibealze width ^ .width; 

^^ynrhisf! 1height “ ^height; 

Tliese lines generate projier accessor mclhcxis, tying the 
proj^erties to a specific instance variable. I he property syntax 
greatly reduces the amount code you have to write for 
accessors. 


Memory Management 

All Objective-C objects are allocated on the heap using 
dynamic metiiory. It is not possible to allocate an 0[:^jecti\re-C 
object on the stack. Using dynamic memoiy in C requires using 
die malloc and free functions, malloc allcx'ates memory 
from the system and free dealkxaies memory, returning it to 
die system. 

Tliere are primarily tw*o kinds of memory manageinent 
bugs you may encounter when dealing with dynamic memory: 
memory leaks and dangling pointers. Memory le;ik.s txTur 
w'hen you fail to deallcxate nieniory. Over lintc, ytmr 
application will u.se more and more memory, which means less 
for other applications. Dangling fx winters (ktuf when you 
dc^itllocate memory too soon and active pointers are .still 
pointing to the dealk Hated memtiry. Dangling jxiinters often 
result in a crash of the application. 

In order to avoid memory liugs in C, every malloc must 
be Tiuiiehed by a free at some point to ensure tliat all allocated 
memoiy is properly retumcxl to the system, “lb help make this 
easier, C code usually adopts a system where eac h piece of 
dynamic memory has a single owner. The owner is responsible 
for freeing memory when it is (lf>ne with it. In order to make 
this work in practice, you have to seiup some conventions so 
you know who is the owmer of a piece of memory. 

Traditionally, memory management of objects in Objeedve- 
C is handled with a tcchnkiiie emailed manual reference 
counting. Reference counting allows multiple owners of an 
object, t'ompared to die single ownership model of dynamic 
memory in C. This drastically simplifies the iiicniory 
ntmagement overiiead the programmer needs to think alx)ut. 

To t;ike ownersitip of an ol)icx:t, you use the retain 
mcdiod lo incTease the reference count. To relincjuish 
ownership, you use the release method to decrease the 
reference count, When the a^fcrcncc count reaches zero, the 
objet't is clealkK'ated and the menuny is returned to the system. 

While the ownership rules aa* simpler in Objectivc-C than 
d>Tiamic memory in C, dica im .still some basic rules that need 
to lie fc^Uowed in order to ensure pn3|KT memory management 
and avt)id memoiy bugs. Here are the memory nianagcmcnt 
mles as laid oui hy ihe Mmort' Managetneni Pwgmmmmg 
Guide for Cocoa: 

You own any object you create. 

If you own an object, you are responsible for relinquishing 
ownersitip when you have finished with it. 

If you do not own an object, you must not release ti. 

I suggest reading that entire memory manageineni guide, 
which you can find on Apple's dt^eloper website, as it conmins 
everything you need to know Ibr [iropcr memory^ mamigement 
in Ohjective-C, Some topics of interest arc dclayctl release 
using autorelease pools, how to write proper accessor methods, 
and avoiding retain cycles. Wc also covered these topics in the 
February 2008 issue. 


Mcim 
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Garbage Collection 

If you are svriting applications for Mac OS X 10,4 anil earlier 
or lite iPlione, you must use manual ntTference eouniing with 
retain and release. However, if you are fortunate enough to 
write applillations for Mae OS X 10,5 only^ you inay choose to use 
garlxige collection for memory m:inagentent. 

With ^Hiage cxilleaion, yon no longer have to worry alxjut 
using retain and release, Ttiu system automatically know^s when 
an obfed has zero owners and is dealkx’ated, As usual, there are 
sotiie edge cases you should he aw^are of, !nil for all intents and 
pur|X)ses, garbage colled ion makes your life much easier. I 
liighly recommend it, if you are able to taiget Mac OS X 10,5. 

Libraries 

11ie second leg su]r|X)ning Mac OS X programming an! ilie 
system libraries. Tile libraries define OS X programming as mucli 
as tile language. Reusable libcirie-s in Objeelive-C are c'ldled 
frameworks. There are two main system frameworks on Mac OS 
X: Femndation and AppKit, 

Foundation contains much of the lower-level leusable 
components, .s-uch as strings, collectioas, and file management, 
iltese objects are generic and usable in most any appliaition you 
may Ix! writing, lii>m comnuinil line to GUI to siTver iLiemons. 
For example, the r(X>t class, WSObject, is pan of the F'ounilation 
framework. In fan, Foundation is also available when developing 
tor the iPhone. Hie iPhone's version of Foundatioji is not iiuite 
as fiilldeatured as its Mae OS X eountiTpari, but you1l find many 
of the same objects, such as NS String, NSArray, and 
NSDictionary avaihibte on Ixith Mac OS X and iPhiwie OS, 

The AppKit framework Is the Glfl framinvork for Mac OS X, 
providing the systenV,s APIs for GUI components such as windows 
and burtons, ihe tt)mbination of Foundation and AppKit is 
knowai as CcKXja, and Cocoa is reaQy the heart and soul of Mac 
OS X programming. 

Developer Tools 

Tile final leg of support are the devek)|X“r tixjLs. Apple 
provides the developiT UKjIs for Mac OS X for free, 71ie 
develofxrr tools include not only a compiler and linker bin also a 
lull blown IDE, Xccxie, and GUI designer, InicTface Builder. 
XccxJe is a fairly adviuxxTl IDE, Tliis Ls whea* you will s|-xmd your 
time writing txxle. It allows you lo edit, ctimpile, and debug your 
ixxle all ilimugh a nice GUL It also has feaiums you would 
exiK*cl in a modem II)H, such as ayux:omplciion and some basic 
a*fatioring t(X)ls. 

Interface Builder is an imixiaanl i>ai1 of developing tor Mae 
OS X and iPhone. Instead of liaving to cn^ate your user interface 
in code l>y iastaniiating windows and view, then hmking tiiem all 
up manually, Interface Builder allows you to do this graphically 
Bui It is nol a ixxle generating ttx>L like many GUI designeni. 
Instead of aeating c<Kfe that you have to modify or customize, it 
CTeates nib files (which have the .nib or .xib file exteasion). 
which contains all ilie objecis for your user interface-, freeze dried 


into a single frackage. At aintime, your nib file gets ItKided, thus 
creating all your objects and htxiking them up afipropriately. 

interface Builder not only allowis you to layout your user 
interface, It also allows you to customize their Isehavior. For 
example, you can .set options on view.s and controls. One 
imjjortaiU custumization is the aiitosizing lx:havior using springs 
and struts. Hits defines how^ contioLs lK*have when the w'indow 
containing the view' Is resized. It allow's view's to stretch cjr stay 
pinnixl to a side of the window. An exam[tli' of the springs and 
struts settings is showm in the AutOSizing .scxrion of Figure 1. 


! o n 

jj 


Text S.ize 



US’ 

o 

^ J 


_Coiilroi Siie_ 

Size [ Regutaf 

V View Size 


3 


Size & Position 



f F rame 


3 


X: 161 Y: ' 142^ 

W: ^ H: :•? 


Autosizing 



Placement 



t3B 

1 


I 


Figure T: Springs and stmts 

Often you need to wriic^ erode to customize how GDI 
components rc^aci io user interanion or customize their Ix^havior. 
]iec'au,se Interface Builder Ls not a code gen era ling tool, it uses 
ii'chmcjues called aciton,s and oiii[ti.s io hcxik ii[^ cxxle to the 
c>l)jects defined in the nib file. 

Actions are metluKl.s tluil an? allied in response lo a user 
interaeiing w'ith u axitrol. For example, buiioas cull ilieir action 
method when the button i.s clicked and menu items rail iheir 
action method when ilie menu item i.s chosen. An action meiliod 
is a meihod that has a special i^tum type of IBAction and takes 
a single atgiiment of type id. Here is an example action metlicxl 
for handling a button prexs: 

• (liAcLion)butLouFtessed:(id)sender; 
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Brush Your Dog’s Teeth 
Lately? 



Replaced your smoke alorm batteries? Copied your files to 
the server? Laptop backed up? 

Despite the best of intentions, there are some things we just 
don't do often enough. And when comes to backup, your 
business continuity is at risk. 

CrashPlan PRO Is the first and only backup solution that 
combines an extremely people-friendly client with a sophis¬ 
ticated enterprise server to continuously protect your 
business onsite, offsite, and online, 


People Friendly. Enterprise Tough 

www.crashplanpro.com 


Mission critical data on remote laptops, desktops and 
servers are backed up in real-time to multiple destinations 
regardless of location. 

Try CrashPlan PRO in a free 30-day triol and make life 
easier for you, your users, and their dog's teeth. 



CRASHPUVNPRO" 

Continuous Backup for Business. 




Mhe sender ar^^umcnt is typically tlie control tliat sent the 
action, in tliis case it would l>e tlie NSButton th^i* the user 
clicked. Tlie IHAction return type is an alias for vt>id, so you 
do not actually return anything. It is used purely as a marker to 
help Interlace Builder identify action methods by scanning the 
header file. 

CXjtlets allow you to hrxikup instance variables or projierties 
to objeds in the nib. For example, if you wanted to aistomize 
ihe lx:havior of an NSTableView, ymt would create an oudet 
and then use Interface Builder to htxikup ihe outlet to tlie 
partictjlar table view in your user interface. To declare an outlet 
for an instance variable, prefix its type with IBOutlet, ^is 
follows: 

XSOutlfit JtSTableView * _tableView^ 

To use an outlet object in your code, you must do so iifter all 
the outlets in the nib are conneaed. A special metliod named 
awakeFromWib gets called on all objeds tltat were reconstituted 
from a nib after all objects have lx*en creattxl and all outlet and 
aciitm connections have lx*en made, ll is in awakeFromMib 
where you \\^ould pul your code to cusU)mize your lable view. 

MVe 

Much of Foundation and AppKil was designed witli tlie 
modekview-controller design pattern in mind. Design patterns 
are reusable ideas and architectures used across different 


programs. The model-view-controller pattern, or MVC pauern, 
is a common .structure lor designing GUT appli< alions* 

'Hie MVC pattern Ls shown in Figure 2, Classes m your 
application should he taiegorized into three distinct roles; 
models, views, and cxjnlrollers. Tlie view classes represent the 
user interface, and are typically the window's, views, and 
controls in the AppKit framew^ork. Example view classes 
include NSButton and NSWindow. The model classc^s 
represent tlie core of your application. For example, if you 
were writing an address fx>ok application, your Person and 
Address classes w'ould Ik* riuxJcl classes. Tim is essentially 
your application without a user interlace. The controller classes 
glue to togetlier tlie mcxle! and the view by mediating iietween 
them. 



Figure 2: MVC Architecture 
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Tlie Rectangle class weVc been using as an example 
is considered a model class. Model classes also know how 
to convert themselves to and from bytes so iliey can be 
stored in a file. The technique of cx>nverting an object into 
a stream of bytes is called archiving, and converting from a 
stream of byres is called unarchiving. An object that knows 
how to archive and unarchive itself miisi implement the 
NSCoding protocoi. The NSCoding protocol is shown in 
Listing 3. 

Listing 3: NSCoding protocol 

iprotocol NSCoding 

- ivoid)encodeWiThCoder:(NSCoder ")coder: 

(id)inimthCoder: (NSCodei •)decoder; 

jlend 


A protocol is just like a method interface, except it has 
no implementation. Classes that implement protocols must 
provide implementations for all methods declared in the 
protocol interface. To inqdemenl NSCoding in our 
Rectangle cla-ss, you could these meihfKls a.s such: 

^pragma itiark - 

i!fpragma mark NSCoding 

(iroicDeiicodeWithCoder: CNSCodt»r •)coder 
I 

[coder encodeFioat:_leftX forKeyi@"le£tX''l ; 

[coder ericodeFloati^otiomY forKeytorwY’*] t 
[coder encodeFloat: .width forKeyie^wldth"*! ; 

[coder encodePloat;.height forKey:i"height'I: 
i 

- (ld)liiltWlthCoder:CNSCGder *)decpder 

t 

oelf ^ [siippr init]; 
if U&li ^ nil) 
reiiirn nil; 

_leftX ^ [decoder decodeFloatforKGyi@’'leftX"]; 

_bqi rcimY “ (decoder decodeFloacForKey;#’*boitoiitY'’l; 
^width “ [decoder decodeFlostForKsywidth: 

^height “ [decoder decod€FlDatFarXeyi@''height"J : 

retvirn self; 

I 

With the Rectangle object implementing we can now 
convert a rectangle to NSData, a class thai represents a 
collection of bytes, using NSKeyedArchivex: 

Koctnngle * rectangle = ...; 

NSUata * data " 

[NSKeyedArchiver archivedDataWithKootObject: 
rectangle]: 

Conversely, you can convert a previously archived 
rectangle back into a Rectangle object use 
NSKeyedUnarchiver: 

NSData * data - ...: 

Rectangle * rectangle " 

[NSKeyedUnarchiver unarchlveObjectWlthData: 

data]: 

We covered the MVC paiiern in detail in the August 2008 
issue. 
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Document-Based Applications 

Anothcrr design pailcrn for GUI applications is called a 
clocunient-haseci application. A doctiment-hasecl applicatitjn 
is one that re,s(>lves around the user editing, saving, and 
opening documents. Bet:aiise this is such a common kind of 
application, Cocoa provides clas.ses to help make writing 
tliem easier called the document-based architecture. There 
arc three classes that comprise the document-based 
architecture, but the main one is NSDoenmont. 

When writing a document-leased applicalitm, you 
typically subclass NSDocument and cusiomizc it for your 
application. Your subclass not only acts as a controller, 
mediating between your UI and the model, it also handles 
saving and opening document files. 

Dirty Documents and Undo 

Users of document-based applications expect dirty 
document and undo support, Dirty document su(>ptm is 
wdien the application tracks changes to a document and asks 
the user to save their changes if the document is closed or 
the application t.s quit. 'I'his helps ensure that users do not 
inadvertently lose any changes they made. 

Documents u,se a change count to keep track of dirty 
stale of the dtK'ument. The change count gets incremented 
every time the user edils the tlociiment. If the cluinge count 
is zero, the document is clean and may be closed without 
losing data. If the change count is greater than zero, then 
the document is dirty. NSDocument does not update the 
change count for you. If you need to manually increment 
the change count, you use the updateChangeCounti 
metliod of NSDocument: 

fiicl r updateChangeCount ^NSChang^DctnE?] : 

Undo and redo suppt)rt dovetails witli the document 
change count. Thus, when a user edits a document, ilie 
change count .should increase and the changes should be 
undcjable. When the user undoes a change, the change 
count must lie decTemented, as w^ell. I'hus, if the users 
undoes all the possible edits, the change count is hack at 
zero. 

Undo and redo support is handled by the 
NSUndoManager class. You typically register the previous 
value with the undo manager before setting the new value. 
For example, to have the Rectangle class support undo in 
its setwidth: method you would register the undo action 
as follows: 

- (voiii)setWidth: (floiit)width; 

I 

if (width ^ _wtdih) 
teturn; 

MSUndoHaT^&ger * undoManager ” *f undoManagerJ : 

(fundoManager ptepareWlthlnvocationTarget;self1 
setHidth:„width]: 

width - width; 

1 
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Typically, you do not put undo support into model 
objects, and you put them in the contrt>lkT layer* The 
example included the Novemtier 2008 issue showed how to 
add undo sup port lo our NSDocument subclass. We 
showed how to use key-value coding (KVC) and key^value 
observering (KVO) in the dcKauncnt to monitor changes to its 


code is very similar from applicaiion to application. It 
shuttles data from the model to the view and also ensures 
user interaction from the views is reflected on the model 
objects. 

Because much tif the controller code is tedious and 
repetitive, Apple tried to engineer a technique to make 
comroller code more reusable. The result is Cocoa bindings. 
By taking advantage of KVC and KVO, Cocoa bindings 
provides reusable controller objects in the form of 
NSController subclasses such as 

NSObjectController and NSArrayController. User 
interface elements are bound lo an NSControiler 
instance. These bindings are setup in Interface Builder and 
rely and key paths. The controllers then use KVC to get the 
value from model objects and KVO io watch for changes to 
model objects. Pigure 3 an exam[)le from our September 
2008 issue that shows how to bind the width of the rectangle 
to a text field. 

Core Data 

While writing model objects is not net'cssarily difficult, 
there is again a lot of repetitive eode. You have to 
implement NSCoding in the model and undo siipi>ort in the 
controller. Again, Apple tries to engineer a teelmique to 
make model code more reusable. Apple UM)k a lot of what 
it learned about objeei-relaiional persistence from its 
WehObjecLs framework, and re-designed it ftjr use in singie 
user applications, Ihe resull is Core Data. 

Because of its objecPrelaticmal mapping lineage, Core 
Data uses database terms, such as entity and attribute instead 
of object-oriented terminology like cla.sses and instance 
variables. 

In the December 2008 issue, we transformed our 
ordinary Rectangle model class to a Core Data entUy, 
Core Data entities are designed using a visual designer and 
are implemented using NSManagedObject class. You 
define all the atiribuies and then Core Data takes care of the 
rCnSl. Here is our Rectangle class, redesigned as a Core 
Data entity: 



n 





j ^ I p i 1 


Vaiwe _ ~ _ 

T 

9 ^ Ma^i Value 


rectangles. 

^ Sind to Rectangle Controller 



Comroller Key 


Cocoa Bindings 

' selectron 

Model Key Path 

Cocoa bindings is a technology to help reduce the 

Imrden of writing controller classes. Much of the comroller 

[width 

Value Transformer 



'* Vatue (Rcctflingle Contn^ler.selctllan.wtdih) 


S 


^ All<iw$ Editing Multiple Valuer Selection 
Always Presents Application Modal Alerts 
CondlcicHiatly Sets Editable 
Q Conditionally Sets Enabled 
O Condltionalty Sets Hidden 
O Continuously Updates Value 
Raises For Uox Applicable Keys 
Q Validates Immediately 


Multiple Values Placeholder 


enumber value-' 

No Selection Placeholder 

f_. _ ,- 





Mot Applicable Placeholder 
<nufiiber vaiue> 

Null Placeholder 


<nombef vaJuv 

Avaitob aiiy_ 

^ Editable 


Figure 3: Width binding to a text Held 
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Figure 4: Rectangle entity 
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Be smart - Backup different 



SmartBackup 

The alternative lightweight 
backup solution. 

Now supports cloning too. 

"Using Saved Searches as include and 
exclude rules is just brilliant.. “ Macgeekery-com 

''Extremely simple - surprisingly powerfur 

Macapper.com 


TRY NOW! 


Trial version available at: 
http://freeridecodmg.com/smartbackup 


We aJso showed how you subclass NSManagedObject 
to add in addirionul derived ailrihules, such as area and 
perimeter. Using Cow Data to impleiiient your model 
classes also means you get utido support for free. Any 
changes made to your model are auiomutically registered 
with the undo manager. By liandling undo and object 
persistence support, Core Data saves you from wriiing a lot 
of code. 

Conclusion 

rhat wraps up a whirlwind .summary of what we've 
learned about programming on Mac OS X, If you haven't 
already, give it all a tryl And check back next month for 
more adventures on Tbe Road to Codv. 

'JiVi 
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(Avoiding) Subversion 
Troubies On Mac OS X 

A few simple steps can help dodge 
big Subversion headaches _ 


r 

by Ryan Wilcox ^ 


What is Subversion? 

Subversion is a Source Control Management system with 
the ^oal to l^e a lietter CVS. Source control is critically 
important when rwo or more programmers are working 
together, as it allows 11 lose programmers to modify the same 
file together, lioth making changes to ciilTercnt parts of the 
file, then Subversion will merge their clianges together. Single 
programmers can als«) use this tool so ensure rite highe.si 
quality code goes into their product — if you look at the 
differences lietween the code on the server and ilte code on 
llie ItKul “sandbox'’, if your changes reduce the quality of die 
code you can simply revert. 

This article isn't about the basics of iiow to use version 
c:orUrol. Mike Zoniek of Clickable Bliss cxfdains, with video, 
the most basic concepts t>f SubversUm in a screencast at 
hffp://blog.clrckableblbs.com/2006/04/26/inffQduction-fo* 
subversion-screencast/. MacTech covered this ttjpic in Vol 22, 
Issue 11 (aka: the NovemlicT 2006 issue), focusing on Xcode 
2.0’s built-in Subversion tools). 

The command-line Suhvension 1,4 client coine.s with Mac 
OS X 10.5 ("Leopard”). For Mac OS X 10,4 and earlier there 
are a number of solutions, from Installer.app in,stallei-s 
(Martin Ott’s Subversion packages are tiiglily regarded, at 
htfp://homepage.moc.com/martinoff />5 or Fink/Mac Ports, to 
compiling it from source. This autltor just tjses MacPorts: 
sudo port install subversion in Tennmal.app) 

For diose more graphically Inclined, there are a few Mac 
OS X native options. There are a number of graphical clients 
for the Mac: the two newest options are Versions.app 
( h ftp://wv/w, versiQnsapp.com/) and Cornerstone 

(http:// WWW, zennaware.com/cornersfone/), Imi there is also 
Zig Version (http://zigzig.com/) and SvnX, 

(htfp://www.lachoseinteract ive.net/ en/ community/subversron 
/svnx/). Xcode also has Subversion support Imilt into the 
Ihoject window, and SCPIugin (http:// 5 cplugin,figris.org/) 


hot-wires Subversion capabilities right into the Finder (similar 
to a Windows client Ciill TortoiseSVN, wliich gives Subversion 
capabilities to the Windows Explorer). In addition to these 
OS X only clients, there are several cros,s-platform ones that 
work in Mac OS X. 

Tliis article assumes yoiiVe using the cuniniand-line 
Sulwersion client, and while it tries uj touch on global 
Subversion concepts and settings, they haven't l)een tested 
with any graphical client. 

Protect Yourself: Ignore Icon 
Files (An Ounce Of prevention) 

Hie transition to Mac: OS X liroughi lots of good things, 
and several annoying tilings old rime Mac ttsers never had to 
deal with under the classic Mac OS. One of these is a 
problem with Subversion: tlie propensity of the Finder to 
write invisible (dot) files, like .DS^Store, .nS_Stc)re files aren’t 
.so bad, l>ui tile Finder also writes custom icon information in 
an invLsible file named “Icon”, wfiere tlie last character in tlie 
file name is a carriage return (CR). That Mac style return in 
die file name plays havoc with Subversion—and will actually 
corrupt your repository in such a way that nobody will be 
able to make new com mils (or checkout, or update). So we 
need to tell Subversion to never allow Icon files. 

Subversion lias an "ignore these files” feature, set via the 
svn: ignore property (please see the Suliversion lx)ok at 
http://svfibook.red-bean.com/ for more information on 
properties, and clieck out the section on Ignoring 
Unversioned Items). However, propenies only apply in rhe 
directory in wiiich they were set—they aren’t applied 
recursively to child directories. The system could put an icon 
file anywhere, so this is no good. There is antrther solution: 
the Subversion Runtime Configuration Area, 
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when subversitJii runs for the first time it creates a 
-subversion folder in your home folder. This holds 
confiji^urmion information for your user on that machine. Any 
settings made here will apply to every subversion operarioii 
you. as that user, make. In particular, we want the glf>hal- 
ignore tjphtm. 

$ cd -/.subversian 
$ piro eonfig 

(Pico is easy. If you have a favoriLe editor go use that.) 

In this confrg file, find the globabignores line and 
uncomnient it. (A comment any line that begins with a pound 
sign,), rhere can be no leading whitespace on that line (I had 
to trim a bit off mine.) 

Will) iliut line uncommented, add Icon* to the end. The 
items in this line are wliiic-space delimited, so ju.st go to the 
end of the line, type a space, and append Icon*. (Icon* 
l)€cause, remember, the Icon file actually has a renirn at tfie 
end!) 

Icon Files (A Pound Of Cure) 

If you do rim into this prol>lem, not to fear, iCs solvable 
by ssh-ing into the Subversion server and executing a few 
svnadmin commands. Subversion has no way to totally nuke 
a file out of a repository, but we t:an cTeare a new repository 
and actively filter out the stuff from the old repo that we don't 
W 2 mi. IPs worth noting here that svn remove just removes 
;i file (Vom the active line-up, btit ifs always there in the 
archives. (Pxcept Icon files wall .still cause trouble in the 
archives, so we want to absolutely remove every last trace of 
it). 

First, we need to dimi[i the repository to a text file: 

S cd ypHth/to/your/repository 
$ sudo svnadoiin dump . ^ ^/repodunp.dunip 

Secondly, we need to find where the Icon file is, so w'e 
can filter it out exactly. Use find, locate, or some other 
search mechanism on your local machine for this. 

Now, for the filtering: 

$ cat ''/rcpodurap.dump [ svndumpfilter exclude 
relative_path to file > WoutDaroTiIconOut.dump 

Two things are important here. Primarily, you must feed 
svndumpfilter your dump file—the path to your 
repository won't do. Secondarily, the exclude parameter takes 
a relative refcTcnee to the file. If you were in the root level of 
your sandbox (tliai is, your checked out Hies), ifs the path 
you would enter to nm a command tm that Icon file, 

svndumpadmin will report on what file it dumped, so if 
you don't see it, somettiing went wrong (not the right path, 
perhaps??) 

Now, move your old repository out of the way and use 
your new' one. loaded with all your data except the Icon file: 

$ nv /path/to/your/repository 
/ path/to/you r / rapos i L<jty_bflckup 
??$ avnadmin create /path/to/your/repository 
$ svnadmin load /path/to/your/repqsitofy < 

“/outDamn!conOut,dump 


The svndumpfilter section (found in Chapter 6 of 
the Subversion Manual) describes this command in depth, 
but this is what you need for now. 

Bundles are just folders 
(with issues) 

In the Mac OS X world many documents are actually 
packages: a cleverly disguised folder ct ml a in tog files, lliis 
goes into Subversion just fine: you simply need to add ihe 
bundle (wiiich will recursively add all the files inside it), then 
add and remove the files inside ihc bundle as they are added 
or removed during work. 

In order to make network operations fast, Subversion 
.stores a copy of die revision (along with other meta-data), 
separate from the copy you sec in your sandbox, on your 
hard drive. Tlus means that Subversion can perform really fa.si 
dill's (without network access even!), and transmit just the 
differences to the server during a commit. Subversion writes 
a .svn folder with this copy, and other adminisiraiive 
infijrmaiion, for each folder in your ,sandlx)x. (CVS does a 
similar trick with ‘‘CVS” folders, sf> if this seems familiar, it is. 

UcKoa document-based a[)plicauons (or to (|uote from 
Apple's Document Based Application Overview: "When ri 
saves a dcxiimcnt, NSDocument creates a backup of the old 
file before it writes data to die new ont\ Backup files have 
the same name as the new' file, but with a lildc just liefore the 
extension. Normally, if the write operarion is successful, it 
deletes the backup I'd el SligliUy confusing sraremenr or not, 
the fact is a new file is created, with die new informal ion, and 
the old version — with your oh so impoitani .svn folder — is 
deleted forever. 

Now, this isn’t a problem for all Cocoa applications: 
some don't save using the normal NSDocument melhods, 
some have a switch you can turn off this behavior with, or 
some explicitly work around it and keep ,.svn around (Omni 
Group products do this, as well as Imcrface Builder — 
starting waih %^ersion 2.0 or so — and Xcode project files). But 
it can still be a problem where you don’t expect it. 

To see this behavior in action, all it takes is TextKdir 
(tested in Mac OS X 10.4 “Tiger" and Mac OS X 10.5 
"Leo()ard”): creaie a file in that also has a picture in it. 
TextEdit will .save this document as a .ril'd bundle. Now add 
this bundle to your repository (you don't have to commit it). 
Viewing the (visit>Ie and invisible) files in this bundle (via say 
Is —la on the conuiiand line) will reveal a .svn folder. 
Reopen the document in TextEdit, make and .save a cliange, 
and l<K)k at lire contents of that bundle again: no .svn folder! 
(Clear away any svn confusion at this point with an svn 
remove —force filename-rtfd). 

The simplest way to fix this is to rename the ruined file, 
update (causing Subversion to re-download the file), move 
the .svn directories from newly downloaded file to ihe ruined 
file, delete the downloaded file, rename tlie ruined file back 
to Us original name, and use svn as normal, 'lliis method 
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sliould work m fhe most rommon workflow^ hut irs not 
guaranteed to work m all obscure siiuations. 

Tills icdinique was descnbecl on the .Sulivension mailing 
list in early 2003 (hltp://svn.haxx.se/dev/archive-2003- 
02/1321 .shtml), and a small Python scripi (called fixsvn, 
written by Nicholas Riley) was attached to this message (and 
is, tliankfiilly, available in the mailing list archive) that docs 

this heavy lifting for you. Use ii as so: 

$ python /path/to/fixsvn ruined_fiie,rtfd 

Since it was written in 2003, before Subversion was 
bundled with the OS, the path to svn is possibly wrong 
(depending on what version of Mac OS X yoirre running, and 
how you installed Subversion, if you had to), but that is easy 
to fix, 

A more modern ,scripi (wriiten in 2007, by Daniel A, 
Sathick, as a scn[H and also as an Automator action!) is 
available at http://sadiiek.blogspol.eom/2007/07/restora' 
s vn ■ i n ■ key n otepoge s^doc um e nts. h Im I. 

There is .some hope on die horizon; the Subversion 
group is planning the next generation of meta-data storage, 
which will hopefully include storing tlie .svn files in one 
central location, instead of in every folder in the wurkiag 
copy. Not having .svn folders in bundles would .solve a great 
headache iVjr people who Ch>r right now) have U) use ihe,sc 
scripts. 

Even with these tw<) scripts, and the new' meta-data 
storage plan, dealing with bundles in Subversion is not 
exactly Mac-like, as the svn client will treat your bundle just 


like a folder: files added by your editing application (TextEdit. 
Keynote, etc) to the Imndle must be svn addeti, and files 
deleted by these applications (w'ilhout telling Subversion first) 
must Ih? deleted with svn remove whatever, file — 
force (so Subversion dtK'snl go looking For the File to 
“helpfully’' delete it for you). 'Hiere is a l.xig in the Subversion 
bug tracker on %vanting to treat liundlcs as “opaque 
collections”, but in this author's opinion, it doesn't have mvich 
chance of being impleitiented (as it is a Mac OS X spec!tic 
bug on a cross-platform project). However, if yoifre 
interested in this, it may be an iniLTcsiing bug to follow, via 
the Siibversif)n project's bug tracker. 

Playing Well With Windows 

In one way, text files are text files, readable on any 
platfomi. In practice, the differing line ending styles of PC 
and Mac/Llnix complicates nioviiig text files from one 
platform to anotlier. G<kkI si)urce ctxle editors respecr and try 
to save text files with their original line endings, but 
sometime good intentions don’t work out and the file is saved 
with a different set of line endings. 

Subversion (and the stantlalone tool diff) respects 
different line endings to one extern: ii will properly display 
the line endings (unlike, for example, opening a text file wath 
Mac or Unix line endings with Windows's Notepad, wliich 
displays the line endiag.s as scjuare boxes). However, this 
means that (if the line endings were accidentally changed by 
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G4 466/733/800MHz: $49/149/199 
G5 1.6/1 .SGHz: $399/499 
Dual Processors (per processor): 
1.8^2.0/2.3GHz: $399/549/599 
2.50P/QP: $699/799 

Xserve Processors 
G4 1.33GHz DP: $189 
G5 2.0/2.3GHZ: $199/599 

Systems 

65 1.6/1.8GH2 $699/799 
G5 1.8/2,0GHz DP $899/999 
G5 2.3/27GHZ DP $1(J99/1299 
G5 2.5GHz Quad Dual DVI $1499 
White Intel IMacsHI 
CD/C2D 1.83GHZ 17" $599/649 
CD/C2D 2.0GHZ 17" $649/699 
CD/C2D 2.0GHZ 20" $699/799 
C2D 2.16GHZ 20"^24" $829/999 
C2D 2.16GHZ /24" W/Leopard $1099 

Need G5 IMacs? 

G5 1.6/1.8/1.9GH2 \T $499/549/599 
G5 1.8/2.0/2.1GHZ 20" $579/569/679 
AIrPort Cards 
Standard/Extreme: $69.99 
802.11 N Upgrades $79.99 
Bluetooth Upgrade $39.99/59.99/79.99 

1 -888-Mac-Resource 
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WWW. mac-resQu rce. com 


Mgw Systems Arriving Daiiyi Caii For 
Latest Stock. 

©Macs GALORE, GREAT 
WORKSTATIONS! 
700 MHz/256MB/40GBA:D: $129 
1.0GHZ/256MB/40GB/CD: $199 


We Have G5 Xserves & RAIOs 
Even If Apple Doesn't!!]! 


G5 Xserve Cluster Node: $1429 
G5 Xserve Full Unit: $1699 
1TB Xserve RAID from $2899 
2.8TB Xserve RAID from $4699 
5.6T8 Xserve RAID from $5499 
3.5i7.0TB Xserve RAID: $4899/6299 


We also carry FIbreCttannel Cards, Drive/ 
ControHer Modules, Power Supplies,. 
Overnight Service 
Available!!!! 


Refurbished Displays 
Aluminum 


20/23 Cinema(DVI): $399/599 
30 Cinema(DVI): $1099 



Crystal 

22/23" Cinema(ADC): $449/499 
15" Studio LCD(ADC): $99 
17" Studio LCD(ADC): $149 
17" Studio CRT, ADC/VGA: $49.99 


All Products are refurbished or 


demo call for more information. 












MOSSO 


SITES SCALE 


extreme visitor surges without skipping a beat. How? !t's 
because from the very first byte served, your sites live on an 
entire army of servers, yvith load-balancing, firewalls, 
network storage, and full backup Included. And the high-,, 
performance scaling and reliability are entirely automatic! 
with no work on your part; Aboutthe only thing we didn't 
upgrade is the price—Mosso technology will probably cost- 
you less than you are paying for a server right now. Sound 
impressive? Learn more at mosso.com. 


Macworld 
Booth 


Mentioned oni 
Digg.com 


Press 
Release 


Servers can be trouble, and heavy traffic can make them 
fail completely. But every day, Mosso’s Cloud Sites^'^ 


hosting technology ppvvers our customers through 


At the moment your site takes off, 
will your hosting crash or keep up? 


WWW.MOSSO.COM I 1,877.934.0409 
















an udiu>r) diff will ^how that the entire file lias changed, 
making it impossible to see what changed by reading the difh 
Committing a file like this means that (a) yoiiVe just changed 
the line endings on all your colleagues, and (b) obscured 
what changed in that revision and (c) make any future 
automatic merges impossible to automate. (At least pre 
Subversion 1.5, where you use the svnmerge.py tool for 
autt?mutic merges from one branch to another). 

One way to prevent this is to always run svn diff to 
validate what you are commitiing, then fixing the line endings 
as you need to. Which works, but wliy use a manual process 
wlien yoti can automate it? 

Siilwersion to the rescue, which allows ytjii to mark a file 
as needing processing on the client side to make sure line 
endings are consistent both on the client side (making sure 
that the file is wriiren out with the native line endings of the 
platform), and on the server side (making sure that the file is 
saved on the server with only one set of iine endings. 

As a side-note: Subversion also lets you force the saved 
line endings, making the svn client write out line endings in 
a particular format (for exanifile, forcing Subversion to use PC 
line endings on a .csv file, even on Mac QS X), via the 
svn:eol-style property. For example: 

S svn propsfit svnleol-style native whatever.file 

To use this, it must lie applied to every new file in the 
repository, which is another thing Suhvetsion can do 
auloniaticaliy for you via its auto-properties feature, liirned 



on via the config file in ~/.suhvers!t)n (wliit'h we edited 
earlier in the article \o ignore Icon files). Uncomment the 
enable-auto-props line, any file types you wish in rhe 
auto-props section of the config file, and when a file matches 
the appropriate expression the properly specified is 
auiomatically added to the file. 

On Windows, at least with TortoLseSVN, the Subversion 
Config(uration) file can be edited via t!te Settings dialog. 

Of course, all the develt>pers in your workgroup must 
also have made this change. 

Concluding Thoughts 

Subversion is an extraordinarily useful tool, and essential 
both to allow multiple programmers to work on a prt>ject 
together, and k> ensure the consistency and quality of a 
product’s source code. This autlior suggests doing a mini 
code-review^ before every check in: reatling your dilTs and 
removing debugging/tracing lines to make .sure the code is of 
the Ik^sE quality it can be. 

However, like many things, Mac OS X throws us curve 
balls. From invisible files WTiiten by the Finder (that make 
your repository error on commit or checkout/update), to 
apjjlications tossing important administrative directories, to 
cross-platform issues, there are tons of little “gnu has’’ w-aiting 
around the corner. Willi any luck, and the techniques from 
lliis arlicle, you1I be able to avoid subversion iroubies on Mac 
OS X. 

References and Resources 

Subversion Book: hHp://svnbook,red-bean.com/ 

Usi of Subversion clients: 

http: //subversion Jigri s.org/l inks. html#clients 

NSDcKTUiTient save behavior: 

http://developecapple.eom/documentafion/Cocoa/Conceptu 

al/Documents/Tasks/SubclossNSDocument.htm! 

Subversion Mailing Lists: ht!p://subversionJrgris,Drg/mailing- 
lists, html 

Subversion Opaque Collection Bug: 

http://subversion.tigris.org/issues/show_bug.cgi?ic{-707 

Svnmerge.py Too!: 

hitp://wvw. orcaware.com/svn/wiki/Svnmerge.py 
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in Software 


■ More than 1000 independent licenses can be protected by one CM-Stick. 

■ One versatile hardware key for all license models including floating network licenses. 

■ Multi platform support including Windows, MacOS X and Linux. 

■ New Distribution Channels 

■ License transfer by SOAP based CM-Talk or file based Field Activation Service in e-shops 

■ Multiple-purpose, including protecting low cost software and digital content. 

■ Unique End User Advantages 

■ First and smallest dongle with up to 2 Gbyte flash drive. 

■ No drivers necessary - can be used without administrator rights. 

■ CM Password Manager, secure virtual drive and secure login. 


■ Highest Security 


Vendor selectable secret and private key. 

Strong encryption algorithms with AES 128-bit and ECC 224-bil. 

Best-in-class tools for automatic protection (envelope, without source modification) 
for Win32, Win64, .NET, java and MacOS X Universal (PPC, Intel). 
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An Introduction to Grophviz 

What is Graphviz and how to use it? 


Introduction 

This article presents GraphViz, a very flexible and handy 
tool that is freely available under an open source license. 
Graphviz helps you draw, illustrate and present graph 
siruciures. Do not l)e discouraged and pleast* do not think that 
“drawing gniph structures” look restrictive and liniiting - 1 can 
promise you that l)y tlie end of the article, you will have 
citanged your mind. 

Tile gCKKi thing is that Cmphviz algorithmically arranges 
the graph ncxles so tliat the outpiil is bolli praclictil and 
appealing! 

Tlie article focuses on using GraphViz from tlie command 
line hui it also presents the PixelGlow ertraphviz version (an 
application with a GUI) tliat is exclusively designed for Macs. It 
also presents Qjnnigraffle that can also render Graphviz files. 

Graphviz can Ix^ used in domains such as softw’are 
engineering, networking, bioin formal ics, daial>ases, wei> 
structures and know'fcdgc rcprc'seniatitjn. The central part of 
Graphviz consists of im[>lenientations of algoritlims for graph 
layout. Most Graphviz is written in C. 

Graphviz in a nutshell 

Graphviz (or Graphtnz orgmpiJiiz) is a collection of look 
for manifiuIaLing pmph structures and generating graph layouts. 
Graphviz supports either directed or undirected graphs. 
Graphviz offers both gmphical and command-line tcxils. A Perl 
to Graphviz interface lilVary is also availalile, lint it is not 
covered here foj‘ reasons of generality. T'here is also a C++ 
interface, 

Strictly speaking and according to ilie "Tlie Design and 
Analysis of (^impuier Algorithms" book, a graph G=iV, 
consists of a finite and nonempty set of vertices V and a set of 
edges K. If the edges are ordered pail's of vertices, ihen the 
gniph is said lo lx* direciecL If Lite edges are unordered pairs, 
the grapli is stiid to he undirected. 

Altltough it may look strange, tlie fact is that you can tlravv 
remarkable ill list rations using Graphviz! Figure 1 demonstrates 
such a draw - and you did not even have to draw a line! 

Graplwiz has its own dialect that you will liave to learn. 
Ihe language is simple, elegjint and powerfuL The gtxxl thing 




by Mihalis Tsoukalos 




alxmt Graphviz Ls that you can wtite its code using a simple 
plain text editor - a side effect of it is that ymi can easily write 
scripts that generate Graphviz ctxle. In fact, tlti.s article has such 
a scripi iliat is writ tun in Perl - my favorite scripting language. 

GniphViz is comprised of tlie following programs and 
libraries: 

'Hie dot prognim: a uiiliiy program for drawing directed 
graph^s. It accepts iii[>ut in the dt)t language, 1'he dot language 
can define three kinds of objects: graphs, nodes and edges, dot 
uses a Sugiyama-siyle hierairhical layout. 

The NEATO program: a utility program for drawing 
undirected grajiiis. This kind of grapli commonly is used for 
telecomniiinkations and (ximputer prognimming tasks, NEATO 
uses an tmplemenlaiion (>f the Kamada-Kawai algorithm for 
symmetric layouts. 

The twopi program: a utility program for <iraw'ing graphs 
tisifig a circular ktyma. One node is di<isen as the center, and 
the other ncxles are placed around the center in a circular 
[>atiem. If a node is conneaed to the center ncxle, il is placed 
at distance L If a ntxle is connected lo a node directly 
connected to the c:enter ntxle, it is filaeed at distance 2 and so 
cm. 

dotty, tcldot and lefty: three grafiliical programs, dotty is a 
customizable interface for tiie X Window System v^mtten in 
lefty, icldol is a customizable graphical interlace written in Td 
7, lefty is a graphics editor for redinic'al pictures. 

libgraph anti libagraph: ilie drawing liliraries. 'I'heir 
prc^scncc means an application can use GraphViz as a library 
rather than as a software tool. 

Drawing Basic Graphs 

Before i start showing you Graphviz exxie, t sliould first 
describe to you some imponani infonnaiion about Graphviz 
ntxlt^s and edges. 

Table 1 shows some of the ncxle attributes whereas table 
2 .shows some of the edge attributes. You can check tlie 
Graphviz dtx'umentalion for the full list of node and edge 
attriliutes. 
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l^me 

liXPLANATlUN 

AU.OWI:d VALURJi 

.shape 

Hie shiipA^ of ihc 

notle 

dlif)st\ dmioond. 
dR-le, 

height 

The ht-ight in inthes 

a numlxT 

width 

'Hie width in inche;* 

nuintiei 

label 

11 le mine tjjf die 

ntJtIc 

alpha numeric 

fonlsize 

The , 47 V of ihf F<ini 

a nurnlx:r 

ftmtrame 

llif naiiw of ihc font 

Courier, F!< 1 verk::i, 

TuiiCii komiEJi 

fontx!t>lor 

Tlif t'ok^r of fht' font 

white. Hack, Hue, 

etc. 

style 

lilt stytt* male 

hold, dotted, filled. 

etc. 

tok>r 

Hie cokir tif die 
node sliape 

white. Haek. etc 


1 wiM now prL\st'nt you wiih the Gmplwiz ccxle that 
generates Figua* i: 



Figure I: A Graphviz example. 


Table t: Node attributes 


Name 

EXI'IANATION 

ALUlWI'i) VAUMiS 

label 

Hie bilK'i cjI Tlie edge 

alphanuiiieric 

fontsbtc 

The size of the kmi 


fonmaaie 

Tlie name of the ft ml 


fonUDolor 

The Cfjlor of the font 


style 

fire style luime 

iMild, dolled, fiJJetl, 

etc. 

ookff 

llie wbr of the edge 

wliiie, l>lack, hkie. 

etc 

Icn 

The length of the 

edge 


dir 

The diretiion of the 

forward, Hick, IxHh 


ixlge 

or none 

decorate 

Draws ii line that 

connetts laliels with 
tlieir edges 

0 or 1 

id 

Opitoml value to 
denote different 

edges 

alphamiiiterie 

Ta 

>le 2; Edge aftributes. 


/• CouriGsy Df Ian Darwin <itui@dirrwiiisys.cam) 

* and Geoff Collyec Cgeaff@plan9.bell-lahE.com> 
' Hlldly updated by Xan Darwin in ZOOO. 

•/ 

digraph uiilx I 
si2e="6,(>"; 

node [color=lightblue2. style-=filledl: 

"Sth Edition” •> *6th Edition”: 

"ith Edition” -> "PVB 1.0": 

”6Th Edition” -> ”I.SX”: 

”bth Edition" -> *1 BSD”; 

”6th Edition” > "Mini Oni*”: 

“6th Edition" •> "Wollongong": 

"6lh Edition” > Tnierdala”: 

“Interdata" -> "Unix/TS 3.0": 

“Tnrcrdata” > ‘PWB 2.0": 

"Interdata” •> "itb Edition”: 

-7lh Rdltion" > "8lh Edillon”; 

*7th Edition" •> "32V"; 

*7lh Ediiloii” > “V7H*: 

”7th Edition" -> "01trix-il“: 

"7ih Edition" ■> "Xenix": 

*7th Edition" ■> -UniPlufll": 

■V7M" > "Ullrix 11": 

"8th Edition" -> “9th Edition": 

"9th Edition" •> "lOtb Edition"; 

"1 BSD" •> ”2 BSD": 

”2 BSD” > "2.8 BSD"; 

*2.8 BSD" -> ■intrix-ll”: 

“2.8 BSD* ■> ”2.9 BSD": 

•32V” ■> *1 BSD": 

"3 BSD" ■> "4 BSD": 

■4 BSD" > "4.1 BSD": 

"4.1 BSD" -> "4.2 BSD": 

"4.1 BSD" > “2.8 BSD": 

"4.1 BSD* •> ‘8th Edition"; 

•4.2 BSD" ■> *4.3 BSD": 

■4.2 BSD" -> *Ultrix-32": 

“4.3 BSD" > *4.4 BSD": 

■4.4 BSD" -> "FreeBSD"; 
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"4.4 

BSD" 

-> “NetBSD"; 

"4.4 

BSD" 

> "OpenBSD"; 

"PWB 

l.D" 

-> "PWB 1.2": 

"PWfl 

1.0" 

> "USG 1.0"; 

"PWB 

1.2" 

‘> "PWB 2.0": 

-USG 

1.0" 

> "CB Unix 1 

"USG 

1.0" 

-> "USG 2.0": 


"CS Unix r > "CB Unix 
-CB Unix 2" -> “CB Unix 3“: 

‘•CB Unix 3" > ■■Uiilx/TS++"; 

"CB Unix 3" -> "PDF^Il Sys : 
"USG 2.0" > "USG 3.0"; 

"USG 3.0" -> "tlnix/TS 3.0"; 

"PWB 2.0" -> "Unix/TS 3,0"; 
"Unix/TS 1.0" -> "Ilnix/TS 3.0”: 
"Onix/TS 3.0" -> "TS 4.0"; 
"tjnlx/TS++" > "TS 4.0"; 

"CB Unix 3“ ■> "TS 4.0": 

"TS 4.0" > "System V,0”: 

"System V,0" -> "Systenj V.2"; 
"System V,2" > “System V.3"; 

"System V,3" *> "System V.4”: 


I found ifiis example in the 
/opt/local/share/graphviz/graphs/directed directory (I use the 
Maeports version of Graphviz). The file Ls called unix2Mot and 
(as I loid you l)eFore) is a piain text file, wlticli means that you 
only need a simple plain text editor in order to write Graphviz 
files. 


Plajtoshop, Better yet, it is also easier to make .small or big 
changes to it. 

The Graph viz c(xle for figure 2 is the following: 
digraph G 
I 

graph [bgcoior^gray]: 

node [stylc^ld, fihapj**‘recordl; 

edge [cEjlor=blueJ; 


graph [bb’-"0.0.343,252"!; 
nodeO [label-*<fO> <fl> J 

nodel Ilahel-"<f0> <fl> E 

node4 [labfil="<fO> <fl> C 

n(Kle6 [label="<f0> <fl> I 

nod62 tlabel="<f0> <fl> tJ 

node!) [lal>el-"<10> <n> N 

TiodeO [label="(fG> <f\> Y 

nodes [lab€l-"(f0> <fl> W 

nodelO [label“-(f0> \<fl> I 
node? Liai)ei="<f0> [ <fl> A 

nodes [lahel=*‘<f0> \ <fl> G 

nodeOrfO -> nodelrfl; 
node0:f2 -> rM3de2;fI: 
nodehfO ■> aode4;fl: 
nodel:r2 > noded;fl; 
node4:fQ Qode7;tl; 
node4:n ) nodclifl; 
node2:f0 -> nodeS:!!; 
node2;E3 > node4;fl; 
node9;f0 ■) tiodeS^n; 
iiode9:f2 > nodel0:£l: 


<f2) vidth-"0.83". heigbt='0,50"] 

<f2> vlilth-“0.B4", heigbt^fl.50“] 
<f2> ", width-"0.S4". hei^t=*0.50"] 
<ra> ", widLh““0.S3". helght-"0.50’'] 
<f2> ", vidth-"0.42". height="0.50"] 

<ra> heiBht-"0.50l 

<f2) ", width“"0.42", height="D.50"J 
<f2> ", wldti]-"0.44", heigbt-"0.50"] 
<f2> " width-"0.&9". height-’’0.50"J 
<f2> ", helght="0.3{J"]: 

<f2> height-"0.50"J: 


■fhe ftode fcoior=ligbthltw2, siyle=filfedj; line of code 
declares some global j>n)perties about each node of the graph. 
You can later overwrite the global properties for any given node 
if you want. Ihe digraph command says that the giaph is a 
direcietl one. Tlie -> notation is for declaring a directed 
connection between nodes. Each line of ccxle ends with a 
semicolon. 

In order to create the out put file using the command line 
Graphviz version you will have to type die following in the Mac 
OS X command line (using the Terminal application); 

$ dot -e/Usets/tttsouk/iiRlx2.pdf unix2.dot 

The -I' parameter defines the output formal. Ibe iLst t)f 
available tnitput formats is a.s follows: canon cmap cmapx 
cmapx_np dia dot eps fig gd gd2 gif hpgl imap imap_np ismap 
jpe jpeg jpg mif mp pci pdf pic piain plain-ext png ps ps2 svg 
svgz tk vmJ vmk vrml vtx wbmp xdot xlib. 

The -o punimcter defines ihe output file name. Note that 
IxkIt the -T and the -o switches are next to their respective 
parameter values without a space character Ix^m^een them. 


As you can see, each node has is divided into three parts. 
Each part has a name: <td> ibr tlie first pan. <fl> for the sec ond 
part and <f2> for the lliird part. In order to call a given pari of 
a node, tlie notation is nodeO:IO - for the first part of node 0. 
The symlxdic name hits nothing to do with the displayed label. 
Also, as you may understand, a ntxle part can lie empty but still 
have a symbcslic name. 



Figure 2: Drawing a binary tree using Graphviz 


More advanced Graphviz 
examples 

This article section will presenl .some more advanced 
Graphviz examples. 

Please lake a look at figure 2. ITiis is a binary tree 
representation using Graphviz and the dot language. As you 
will see it is very easy to create it - I tlunk that it would be a 
lot liarder to illustrate it in either Addie Illustrator or Adolie 


I'he Gophviz ccxle for creating our next example (figure 
3) i.5 the following; 

digraph G 
t 

graph Irankdir = "LR" ]; 
tiDde[fqntaixe = *14" style-bcild]: 

# Table field connection part. 

BONUS Iiab€l="<tb> BONUS | sal | comni | ename [ jqb" 
shape = "record"]: 

DEPT [label-" <tb> DEPT | loc [ dfiaae | deptno” 
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management 

TOT your entire 
organization. 



Now I Up to Date' and Contact'5 

Caiendor and Contact Software for Business, Groups, Fomtiies and You. 



New 


Phone: 866-527-0556 
Web* www.nowsoffwarexom 


Is this projed on schedule? When ore you available \q meet about the systems 
upgrade? Where are all the Field techs today? When was the last time onyone talked 
to our biggest customer? 

Virtually oil groups live (or die) by their abilities to meet deodlines and keep frock of 
their customers, prospects, and vendors. Few small companies or even deportments 
of big companies have the fools they need. 

Now Up-to-Date & Contact might just be the calendar and contact softwore for you. 
IFs time-tested and used by more Mac-based componies than any other solution. And 
it's cross-platform-Qvailable for your PC users, too. IPs easy to install and monage and 
simple for your employees to understand and use. 

Using Now Up-to-Dote & Contact you con schedule meetings for multiple users, view 
multiple, simultaneous colendors, and reserve rooms ond resources. You can shore 
contact information obout your customers, prospects ond vendors. And using our free 
server software you con set it up in minutes and shore with users in the office or from 
anywhere with on internet connection. 


Coll us now ot 866-527-0556 or emoil us ot moctech@now5oftware.com 
and weil send you our Iree evaluation kit, inctudmg the book that wifi 
make it all easy, "Toke Control of Now Up-to-Date & Contoct'' fronni 
Toke Control books! 


Copjfriglil O by Mow Sciflwora. (nc Ajl ripMs Fiejervcd Now UpPO'Dalo ond Now Ccnioci ofo rogriNncd Iroctaniork* of Now Soflwone. Inc. Mnc; ophJ ih* etro irccltmct'ki of Apple Compulor, Inc, 

regutOPtid In rbo UiS. ond OJhiir All odier ln:3dniiiark« aclcnowledg«d 







fihiipe =“ "record**!! 

tMF [iabel*=''(tb> BMP | | enaro | cam | i^r | hldedate | deptno [ 

job" 

shape “ "record"] 

Qjm flabel-"<tb> OIENT | sal | cana | enaae [ job* 
shape = "record"]: 

CLF^ [label-"<th> CLERK | sal | coan [ anaios | job" 
shape "record"]: 

ORDER [label-"<tl!> ORDER | sal | com ( enaae | job" 
shape “record"] ; 

FOO flabel*"<th> FOO | sal | cem | emme | jdi" 
shape "record"]; 

# Tablespace decoration part, 

■J1_UOTS [Iabel’*”<th> USERS" shape = "record" £tyle=fiUed color“'*red"J; 
“node 10" Ilabel*"<tb> DATA" shape = “record" style^filled color**"red"): 
llLADHiW [label**^<tb> ADHUT shape = “record" style=filled color“"red"j: 

# TABLESPACE table connection part . 

HtMISith 

DEPT!tb ■> lli„IMHS!tb! 
aTTNTjtb -> 'HJJSatSrtb: 

OaHRjtb ‘> TB_USEHS!tb; 

0(P:lb > nodel0:th; 

CLB»K:tb > nodelOstb; 

POOab > HLAffllMitb: 

I Tablespace to tablespace cormection, 

TB USERS ■> "nodelO* ■> TB„^DffiN: 

TB_iDHlK > TR.iraSs 

label = "Out UataBaae Sclietna"; 
fontaiKP^O; 

TIiLs is a database S4*hema, visualized with tlie help of 
Graphviz. llie pre,sentet! sdiema is simple; never!lieless you 
am still imtlerstnnd iiow elegant this is. By reading the 
Graphviz eode you am understand tliai lines beginning with 
the ^ dianicier are eommenis. 


Using Graphviz on a Mac Part 1: 
PixelGlow 

I hrsi have lo tell yt>u lliat if you decide to use the 
PixelGlow Graphviz version, you will not need the command 
fine CcxjIs, PixelGiow s version will render the Graphviz code for 
you. Next, I should tell you iliat PixelGlow's Graphviz won Best 
Mac OS X Open Source Pnjdiict and was runner-up in Best 
Product to Mac OS X in the 2004 Apple Design Awards. 

Ihe Mac OS X version supports native fonts, exporting to 
all Quicktime image hirmats^ on-line viewing of the oufpui, ett\ 




You may fmd it surprising, but the presented graph in 
figure 4 -diat alsci shows tlie PixelGlow Graphviz GUI- uses the 
same Graphviz code that created figure 611 only dianged some 
Gmphviz properties using the PsxelGlow' version and, as you 
cdn see, the new' output is totally different! 

Using Graphviz on a Mac Part 2: 
OmniGraffle Professional 

Macintosh users have another opt it m for rendering 
Graphviz files: OmniGralllcc 

What is .special alioiit Omnigraffle is that it allows you to 
drag-and-drop a node or a group of nodes in order to rearrange 
your graph according Lo your needs. This is an excellent feature 
that ailow's you to fine aine your output. 

Figure 5 show^s Omnigralifle proces,sing a Graplwiz file. 
Again, you do nor need the command line Graphviz tools to 
render Gniphviz code when using Omnigraffle, 


Figure 3: Creating a DB Schema using Graphviz. 
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If you have a smartphone, 
we can sync it. 



The Missing Sync product family connects the coolest devices 
with Mac OS X. Reliably synchronize your address book, calendar, notes, 
music, pictures and more between your smartphone and your Mac.* 

visit www.markspace.com/reiiabie 


'Avaiiabto for ai^kbeny. Windows Mobile. Palm OS, /^ppte iPhone, and Symbian QS devices. 

Smartphar^e fastines Vffly from modcd to modc^, so synchronization features and cap^siHlies wi vary from product to product 
The Missing Sync Is a registored iradamark of MerVSpace, Inc 































US€ File::Find: 

File: :Bai36naaie; 



Figure 5: Using OmniCraffle with Graphvii files 


A perl script that produces 
Graphviz code 

When I w;ls writing; my eBt>ok lk4shk>cird 

Wid^i^ets'', 1 %vnnied to visualize the structure of most of the 
presented Widgets, I decided to use Grapltviz and f wrote the 
presented Fed st'ripi in order to autoniaticully CTeate the 
Grapliviz code, 

Tlie Perl code for tiie script Cl called it Wslrncipl) is as 
follows: 

#!/usr/bin/peri w 

# $Id: ch2.tex1.1 20C7/U/ZI 15;5/;t)l mttjatik Exp $ 

# 

II ThliJ software is provided without any guarantees 

# Please note that thia is alpha code 

# 

# Prograuinier; Wlhalls Tsonkalon 
If Bate: TTnirf^day 16 Harch 2006 

# 

fl For my eBook on Dashboard Widgets 

ff 

# ' * • Commaiicl line arguments 

jj| * * - prograifl_naiae.pl directory 

# Please note that the directory argument uusl not contain 
? an / at the end* The foltowing is a correct example: 

i? prograni..naiiie.pl /Library/¥idgets/Weather*wdgt 

# The foUowing fs a WRONG example: 

# program name.pi /Library/Widgets/Weather.wdgi/ 

« 

t This graph does not Include PNG files 

« 


use strict: 
my $directory=’""r 
toy XniHECTORTES=(): 

die <<ThanatDs unless #ARGV: 
usage: 

$0 diteciory 
Thanatoa 

if { §ARGV 1= I J 

f 

die ^CThanatos 
usage info: 

Please use exactly 1 argument! 

Thanatos 

I 

If Got the file name 
CSdirectory] = @ARGV; 

print «START: 
digraph Widget 
1 

size-^16.6"; 
nodesepH).05: 
rankdir = IR: 
rotate ” 90; 
edgeilen=2j: 

node[style=ftiled. shape^record. fontsize=8l; 
node[height=0*20t width*0,20* color-grayl : 

START 

find (\£icroate_graphviz. $direcLory): 

print <<END; 

I 

END 

exit 0: 

iSf 

# 

sub croato_graphvi2 

( 

Iprliit 

Sprint “Vn": 

ff Skip ..US Store and ALL png files 

if { $ — II S_ /\DS_Store$/ II -- 

/png$/l ) 

I 

# do nothing! 

I 

else 

i 

# if it is a directory, then,,, 
if f d $File::Flnd; :natiie) 

I 

# Duplicates can only exist in directories. 

§ We must take care of li. 

If { ! deftnedCSDiaECTORIESrStile::F]nd::namel) 

) 

( 

$DIR£CT0RiEStSFllei:Find::name) - 0; 
create_node($Fll€: :Find: :nanie): 

1 

] 

(f It is a file. then»,, 
else 

t 

create„leaf (b 0 Senaitie{$File: :Find : :name}): 
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I 

I 

» 

i 

# 

snh crente^riode 

I 

my Spath ” shift: 
print * 

print flabel^\"".baaenaiiioC$path) *'*\"]: \n*; 

# Create the connection with the parent node 
print "’// Crente the connecUon with the parent 

nc[de\n'*: 

# If the $pflr.h Is not equal to the $directory variable 
Lhori.,.. 

if Upath no $dJrectory) 

( 

print : 

print “ *> V'"‘.dlrnaine(Spath). *‘\"*:\n**; 

If f I dcrined(SDiKKGTORiESIdirnaiiie(Spatb)n ) 

[ 

$DlltKCTORlES($p0thl = 0: 
create nodF(dirname($path)): 

I 

i 

else 

t 

# Create the node for the parent directory 
S of $directory 

Sprint ** \***.Spath: 

#prlnt -\'‘[l 0 bel“\"".basenaH»e{$path),"\"J :\n'’: 

I 

I 

sub creatp_lftflf 
i 

my $fne - ahl fl: 
my $alze - 0: 

# It Is always a good Idea to check twice! 

If c r snie) 

f 

# thia finds the aiae of the file in bytes 
$size " s Sflle: 

) 

# add the byte symbol at the end of the byte number 
Ssize 

# create the file node 

print Sflle; 

print "\**[label“\“" pbasenssaeCSflleK** " .Ssize,; Vn" : 
print * 

print * *) \"">dirnanje£SFlle: ;Find: rnaiFie). ; \n": 

if { ! deflnode$DIRECTORibS!dirnarae($File::Find:;name)1) 

) 

I 

SDiRECTORIES!dirnaiBG(SFile; :FiTid: iname) I = 0; 
c roaLB_tiode£dirtiame($Fiie; :Find: inatne)); 

I 

I 

1 am not going to explain you llic fxfd axle as this not the 
purpuse f>F this article, but 1 will give you im example of its 
output. By running the perl script (/WstrucLpl 
/Library/Widgets/Weatber.wd^t) you will get the following 

Graphviz code: 
digraph fidget 
I 

size-“ 16 , 6 *’: 
nodeaepK) * 03: 
rankdlr = LR; 


rotate " 90 ; 
ed|eUen=2l r 

nodefstyle^Jlled* ahnpe'"record, fontsi 2 e=a|: 
nodelheight^0.20, width^0.20* color^grayl; 

* .identity" [label^’ .identity 22^i0b"l; 

“.identity" > “/Library/tfidgets/Wenther.wdgt"; 

“ /Library/Widgets /Weather.wd gt“ f label*‘"Wea ther. wdgt" ]; 

// Croaie the connection with the parent node 
"Info.plist" flabel=’'Tnfo.pIiat 107Bb"]; 

"rnfo.pliat" -> "/Library/Widgets/Weather.wdgt*: 
‘■veraion.plist" [label’'"versjon.pHst 431b"]: 

“version.piiSt" -> “/Library/Widgets/Weather.wdgt”: 
^'Weather .css “flabel^** Weal her .css 33/tb’'] : 

“Weather.css" -> “/Library/Widgets/Westher.wdgt": 
"Weather.htinrl “ Mabel=“ Weal her. hi ml 4307b"I: 

“Weather.htffii“ "> ^/Library/Widgets/Weather.wdgt“: 
“Weather .js“ llabel”“Weather .js 363q0b*'J; 

“Weather.js" -> “/Library/Widgetfl/Weather.wdgi"; 

'•/Library/Widgets/Weather.wdgt/EngUnh.l proj“ [label”‘'EngUsh. 
Iproj-h 

// Create the connection with the parent node 

“/Library/Widgets/Weather.wdgt/Engiish.lproj** -> 

/Libra ry /Widgets/Wea the r. wdgr “ ; 

“InfoPlist .strings" Uabei^'’InfoPlist .strings 66b"l ; 
“InfoPlist.strings" -> 

“/Libra ry/Widget s/Weather.wdgt/Engiish,Iptoj": 

" 1 ocalizedStrings,Js" [1 abeH" 1 oca 11 zedStrings. js S58b“J: 
"locallzedStrlngs,js“ '> 

“/Libra ry/Widgets/Wea ther.wdg L/English.Iproj": 

“/Library/Widgets/Weathe r.wdgt/Images"[labelTmages"]: 

// Create the canneciion with the parent node 
“ /Library/Widgets/Weathe r. wdgt / Inta ges " - > 
“/Library/Wldgets/Weatber.wdgt"; 

“/r. ibra ry/W]d ge L e/Wea ther.wdgt/images/Icons"Liabel-"Icons"]; 
// Create the connection with the parent node 

“/Lib rn ry /Wi d gc Ls/Weather. wd gt /1 mages/ Icons " • > 

“ / Li b ra ry / Wi d get s / We a the r. wd gt / Tmagf; s “ ; 

“ /Library/Widgets /Weather. wd gt / Tmages /Tcons/moonphases " [label 
•“moonphases"]; 

// Create the connection wUh the patenL node 

“/Library/Widgets/Wcather.wdgt/lmagee/Icons/moonphases“ 

-> "/Library/Widgets/Weatber.wdgt/Tninges/Icons": 

“ / Library/Wi dgets/Wea rher. wd gt / Images/Mini s " [ labei=^"Minls" J ; 
// Create the connection with the parent node 

“/Llbrary/Widgets/WeaLher.wdgtHmages/Minis" -> 

“/Library/Widgets/Weather.wdgt/Images"; 

) 

Figure 6 shows tlie gni[>}i ihai you will ge! Jifter manually 
compiling the generated code using dot. 



Figure 6; Using the Wstruct^pl perl script - an example. 
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FREE with every domain: 

FREE! Starter Web Page 
FREE! Getting Started Guide 
FREE! Complete Email 
FREE! Change of Registration 
FREE! Parked Page w/ Domain 
FREE! Domain Name Locking 
FREE! Status Alert 
FREE! Total DNS Control 
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www.mactechdomains.com 
to register for your domain today! 


Please note that the Wstruct^pl perl script titles not intlude 
PNG flies tn its oiitpiit. Hits was a design decision in order to 
avoid the Inisy out pul tltal some Widgets may have because 
they ctmiiiined a plethora of PNG files, Also note that only 
regular files have their size in bytes next U> them. 

Conclusions 

1 hope that yon find Grapliviz Ixjth entertaining and 
interesting. I tliink thai it is an exceptional piece of software 
tliat Is very capable. Finally, there is pleniy of useful material 
available in tlie web links provided, so you are Ixnnid to find 
some benefits through exiXTimenting. 

Books and Web Links 

'‘A Tcclinique for Drawing Direcled Graphs". Gansner, E, 
R., Koutsofios, ll, North, S. C, and Vo, K. IEEE Trans. St>ftware 
Engineering, May 1993^ 

“An alg<iriiiim for drawing general undirected graphs". 
Kamada, T. and Kaw;u, S, Informal ion Pr(H es.smg Letters, April 
1989, 

AT&T Graph Viz site: 

http: //WWW. resea re h .att, com / sw/tool s/grophviz 
Graph Viz Developmeni Wt^b Site: 
http: //www.g ra ph v i z .org / 

PixelGlow: http://www.pixelglowxom/graphviz/ 

Alio. Hopcrofl and lUlmari. Iht* Ik'si^n and Analysis of 
Qmifmter Algorithms. Addison Wesley, 1974. 

Michael Jiinger, Petra Mutzcl (editors). Graph IJrawing 
Springer, 2003. 

“GraphViz and i^latis N, and Tsoukaltjs M., C/C^-+ 
Users Joiirnal, December 2003. 
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Integrating OS X With 
OpenLDAP/Samba, Part 2 

An article, in a series, on “Configuring Your Mac 
To Work With Linux Samba and LDAP Servers.” 


by Noah Gift 




Introduction 

In Part 1 wc covertfcl tiilking to a Samba Server running on 
an IJbuntu Virtual Machine, hui we stopped at merely obtaimng 
rciid only access to data. In Uiis article we fully configure 
Samba on Unux in an ideal c(3nfiguraijon ft^r OS X. and then 
get into aiiUicntlaiting all of this to LDAP on Linux. 

Because we delve into a fairly complex untlerlaking of 
getting Linux and Samba configured inside of OS X, it is 
important to point out iiow powerfiil rliis combination truly is. 
OS X, universitlly knewn for simplicity and ease of use, can yet 
again, hide the complexity of a Linux sender wit I tin the 
shadows of its own operating system by using virtualization. 
Linux servers talking to, and amning Inside tjf OS X is a very 
compelling choice to consider, as it et>mbmes the strengtlis tjf 
ix)lh platforms, and minimizes their respective weakne.s.ses. 

Dirt Simple Home Samba 
Configuration 

In the last article, we downloaded a pre-configured 
Ilbumu Virtual Machine licixi: http://examples,oreiily,com/ 
9780596515829/vm/ and then gtM il liilking to Samba, but we 
only liad Read-Only access. Now it is lime to opiitiiize the 
configuration file to tmke file^shadng w'ork a>mpletely with OS X for 
a typical home seiup liehind a firewall. 

if you TTenienil>er from the previous aiticle, we created a very 
tiiiniinal read only configuraiiori. Here are tlie steps to get a full 
read/write configuration working from scratch with zero 
aulheniicaticm, TItis Is (lerfect for a home network lx^hind a firewall, 
in which uu LLsemamc or password is desia^d in order to connexi to 
the sliare/. 

If you aa still working off of the downloaded virtual machine, 
then go ahead and edit /etc/samba/sinb,coiif and add the contents 
Ik‘Iow. (Remember that the usenumie and password is py4.sa. 
Alternately, you cm .simply ii.se thi.s configuraiion on existing tJhuntu 
Virtual Machine or server you already have ninning.) 

Step 1: Fclit the snib.conf file 


Listing 1: (zero security) samba config 
/etc/sa mbu/sm b. co nf 

[global] 

workgroup = home 
netbios namo “ py4sa 
security “ share 
Uhare] 

ruittfuent - Home Pile Server 
path = /u^r/export 
Force user *= py4sa 
force group ^ py4fla 
guest ok - yes 
read only = no 

Will) this configuration file stjuared nwiiy, next wc need to 
cTeate the actual directory to share out, change die ownership, 
and restart samba. 

Step 2: Create the shared directory mentioned in the 
configuration file 

py4s6@py4sai^$ sudo ntkdtr /usr/export 

Step 3: Change ownership to match the '^forced'’ user and 
group privileges we set in the configuration file 

py4sa0py4sa ■■^S sudo chowfi -H py4sa‘py4fla yusr/export 

Step i\ Restart the samba daemon 

py4sa@py4sa:'”$ sudo killall HUP anib 

Willi this out of the way, we can perform a command line 
debugging step first to see if our share is available. Under OS 
X, we can simply run this command (note that your 1? address 
may Ix' different): 

[ngift&nac ]ntoflh'eHH;743] sudo ambclient -L 

// 192 . 168 . 1.200 
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Next, we should see some form of output Like this: 


Domain-[HOHEl 

OS-lttnixl 

Server-[Saiba 1*0*26a! 

Sharcaame 

Type 

Comment 

ham 

Disk 

Home File Server 

IPCS 

I PC 

TPC Service (Samba 3.0*26aJ 

DQiaain=[HOMKl 

OS-IUni*] 

Server=[Samba 3*0.26al 

Server 


Ccunmeat 

FY4SA 


Samba 3*0*26a 

WorJugrgup 


Master 

HOME 


PY4SA 

MOTHKRSHTP 

MOTHERSHIP 


Here, we cm see that our share is indeed alive, and it is named 
“shared with a comment “Home File Server”, just as we wrote* 
I am a huge advcKJite of doing the simplest possible thing tltat 
will work, and in our situation, this is quite literally, the simplest 
possible <’onfiguralit)n a user could wani on a home network* 

Tills configunUkm creates a sitiiple read/wriie share that 
requires no password from a Mac* In the next secijrin, we will 
go through the ccmnec1it)n prcK'ess. 

Mounting Samba Read/Write As 
Guest 

Now, lliat we have Samba configured, and running, we can 
simply mount the volume by using “Apple + K'\ Here is a 
sequence of screenshots slunving the prtxesses. 

^ r\ Connect to Server , 

Server Addreii 

jmb://192.168,1.200 _ _ L+J 

ravonte Server^ 


0 Remove ( Browse ( Conowt ) 


Figure 1: Connect To The Samba Server 



Figure 2; Authenticate as Guest (No password required) 
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Figure 3; Test Read/Write Privileges 

In the sequence of scrt*enshots shown in Figures 1 tit rough 
3, we demonstrate how liandy this simple “home lirew” Samba 
Server really is. It allows us to setup read/write privileges for a 
guest user in seconds. Having iliis lif) in your back pcxkii can 
sure get you our of some jxjicntiul problems in a pinch, such 
as sharing a common web development environment. The nice 
thing about using a virtual machine rurining inside of your Mac 
is tlial the complexity ran sinqily be turned off when you're 
done, or alternately, it am run forever as a sender inside of a 
desktop Mac, or perhaps Mac Mini, 

Now that we kive cDnc|uerc‘d die simple Samba setuf) for 
OS X clients, let's get into conc|uering the simple [.DAP setup 
for OS X clients, 

OS X to Linux LDAP 
Configuration in 60 Seconds 

I.DAP is another protocol ihai can lie a complete pain to 
deal with, a.s it tan get (|uite complex for the newhie in a hurry. 
In this section, though, we reuse a pre-conrigured •‘vanilla’ 
Libiintu [.DAP .server running on the virtual machine we 
downloaded, and shudder, aulhcniicate our OS X client directly 
to it in about 60 .seconds. One of the retisons why this is so easy 
is because we have a pre-conRgured virliial machine, which 
hides ihc c;om|>lexity of setting up LOAP initially from sc:ratch. 

Our goal in this .sc-ciion is. once again to do the simplest 
[Kissible thing that works. Here is a sequence of screenshots of 
authenticiiting to LDAP; 
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Figure 4; Using Directory Utility to create 
a connection to LDAP 


Figure 7: Still using Directory Utility, we manually add our 
new LDAP server to the search path. 
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Figure 5: Read the error message, (Note, Linux LDAP 
doesn't just work out of the box). 
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Figure 6; We use advanced settings to configure a RFC 
2307 mapping (chosen from the drop-down menu). 


Figure 8: In the Accounts Preference Pane, we setup “fast 
user switching," simply to allow easy testing of LDAP user 
account logins 


Authenticating to LDAP 
from OS X 

Now thar we are configured to talk to Linux LDAH let's test 
it out from tlie comiTianil line by interactively exploring our 
LDAP session from the awesome ‘‘dsd’' coninmnd line Ux>l, 

Listing 2: expioring LDAP from the commandline 

[nglft^macintosh StJH:753][JiOl# dsct 

Entering Interactive mode... (type “help" for commands) 

> Is 
BSD 

LDAPv3 

Local 

Search 
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Contact 
> cd L0APv3/ 

/LDAPvS > Is 
192,166,1,200 

/LDAPv3 > cd 192,168.1,200/ 

/LDAPv3/192.168a,200 > is 

Autoitourtt 

AutomountHap 

Certl ficatP-Autiidrlties 

Gi:oupa 

Mouels 

People 

Users 

/LDAHV3/192,168.1.200 > c4 Users/ 

/LI>APv3/192a6a. 1.2f)0/tJsers > Is 

nobody 

pyAsa 

root 

'IliLs infemctivc st.‘,s,si<m for ilie dscl ajimiiutid shows us that we are 
indcLtJ ainncaetl to die LDAP ditmory on the IJnux sem^r, and 
cin see tlie user ateounts on diat machine, siic^h :ls py^tsa. Next, 
lets actually login tusing that acaiunL 

If you n<Aicx\ we can lt)g in as die user* but w get a 
weird emir from bush, tiecaase diere is no home liiredt jry spetihetJ 
inside of LDAP 

Listing 3: using lyy4sa to login 

[tiglfta»atintosh'8 lHi7611 iJjOl# m pyAsa 
Password; 

bsahi /home/py^sa/.baBhrc: Input/output error 

bash 3.2$ whoami 

py4na 

llie final tiling to lest Ls to amially do a fast iLser switc h login 
to die new "py4.sa” acanini that gets pulled from the LDAP datatXLSe 
on ilw Viniial Machine. If you go diiougli witli the iir(K'ess it will 
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liang for alxiuT 30 seconds, and tlien bring up a warning that ii 
ccHildn’i find llie aser’s home dirLXiory, yet still login, to a tempomry^ 
liome dnectory. 

So wtoi does this pawc? Well, It proves that we ktve die 
simplest possible Samira, and LDAP connectioas running from a 
yire-uonfigured vinuaJ machine. Not lo shafiliy for some virtual 
madiine file on your file system. 

CONCXUSION 

In diis setxind article in a four pan scaies, we fully configured 
a Reacl/Write Samba sliare running ofl' of a virtual imciiine. llie 
,security wiLs intentionally .set to allow not nequiie a user name and 
password, as diis is very appmpriate for ad Ikx: or home 
networking. 

Next, we did tlic simplc'st fxissihle Ii)AP authentication w^e 
could liy configuring OS X to talk lo the .same vimial machine. We 
stopped at really doing anything t(X) ustdiil iliougli, as w’e weren't 
able to use a home tliatTory' yet. In die next article, we go l^eyond 
our simple Home Samba Server, and lighm'eight I,DAI* 
configuration, to .setup a sample Enterprise configuration, diat ties 
in home directories, 3^^ ixirty LDAP administration tools, ajid more. 
In the final and fourth anide we dien Take our enterprise 
l-DAP/Sanilra configuration, and tmke tie in autheniieation to 
Apache and I'mc. ’Ihis allow.s for one firticrackcT of a virtual 
machine, diat ag:iin, is ju.si some file .sitting on your 05 X box. 
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Printers 101 .... ... by Dennis Sellers & Neil Ticktin, MacTech Editorial Staff 

There are so many coasideratioas when bayiag a printer. Here are the issues to advise users on. 


Welcome 

Have you Ixfen iiskal alxiuL buying a or yoii are 

l(x)king to Imy a prinkT yourncHl? Tlieie aa* exiKtly 1,032 Mae 
a.)mpatib)e mcxlelM fnini vvliich to chtxxsc. Okay, we inade tliai up. 
Bill sometimes it seems that way. Tlieie are a jilelhora of printers 
fnim whieli to pick, and Mac'fech Is liere to hei[:j you advise others 
on (or help you) M‘leti tla- riglti one, With so mtmy diffeieiiL 
printing lecimologic'S suited for dillerent priming ncxxis and 
i7udgeis, ilieR^ arc a lot of tilings to aiasider. We've sfxmt the last 
sev'eml nxintlis looking ai a wide variety of HP printcts putting 
them thnnigh real life paces to see how things actually \\x)rk. 

Standalone or multi-function 
device? 

Firsi of all you shtruld dtTide if you want a standalone printer 
or a multehinction primer (t>r, “MFIV also known as an "All-in-One" 
printer). If you luive Ixisic printing mxxls and mn a small 
ofFK'e/tiome (office (or are simply cmmped for space) a cm 
save you lx>th nxim and inf>ncy as iIk'V also offer copier, fax and 
scanning functions. On the down side, if you nin oiii of ink, or tlie 
michint* f)R‘uks. yoti could lose all himiionaliiy, not just printing. 
Also, most MVVs often don't have top-t)f-the-line printer hinctkms, 
so you're printing large or detailed photos, a .stancljlone device 
might Ixiter suit your puqxxses. You cin llnd a nittl-mnge multk 
function inkjet printer for less than $200. 

For workgniups, and small t)fTt€es, there are sotix^ realty 
aniiizing iniilti-funclion color lasers tliat easily replaee the 
suTef)rypical co(7y inacliines of the p 2 Lsr. We doni nomxilly tliiiik 
of printer etjmpanies like Hl^ as pncxlucing eopieu^, hut die mid- 
high volume multi-hmcion dc’viees are every Ixt the digital ctipier 
dial the typical "copier lirands" And, dieir Mac iniegraiion is far 
I viler. 

One thing to retdize widi a nciwori^ed MFP Ls that yi>ii gel 
network sainning ami faxing as weU. In particular, Mac siippcjit lor 


ilie consumer lines Ls cjuite gcxxl and pctiple can Stan riglit from 
their desktops. 'lliLs inclutk^s not only pictures, and ckxiimenLs, Ixjt 
you can also afiply OCR tedmologies ( which still has a ways to go 
on accuracy). 

Inkjet vs. Laser Printers 

Also, you must ckvide if you w^ani an inkjet or kser printer. 
Inkjet printers are the leitsi expensive of tlie two as they're primarily 
sold or given away liy the printer armpanies m entice you to buy 
their ink and cartridges, as well as sptxxdty pa|vt (e.g., photo 
pajXT). Primer nianupicturing companies exjvcl a printer will Iasi 
the consumer alx>ui Xi monlJis, accoaling to die folks at die Ink 
for Your Primer wd> site (htlp://www.ir\kbryourprinter.oorTi). 
During diat time die emsumer will pay lor die printer in the fiisi 
mondis of use of nirtridges, ihey add, 
inkjet.s can I v purchased with either a single ink c'artridge, or 
tip to SL^cn or eiglii sejxirate ink cxirlridges. Having septiraie 
ciiriridges aR Ivtter tor liighcr tjuality printing (ailors are more 
precise*, especially widi photography) and ink consumption 
efficiencies aie tieller. 

We wea" once told that ihai ink Ls one of the nicxst expensive 
sulistances (e,g., price per giillon) aamnd, Qirtridges aa* 
mjmufacttiad idr ceiiis and ua^ sold for maximum [iroht. The $30 
l>t‘ll or HP curlfidge costs alioui 30^ to manufactua% distribute and 
sell, acconJing to Ink for Your Printer. So you 11 get a great deal up 
faint, but have to pay for it kuer in incremejus (sort of like with the 
iPhone 3Cr, come lo diink of it). What's mom, you can often find 
inkjeis bundled with new computers or as t)an of sjxvial deals. 

liista: primem exist moa^ up front, but liave historically had lower 
tbllowHip ex|v*ases. It wasn’t rminy years ag^i that laser printers, 
t*spc‘cialiy cxik:^ iixxieLs, were simply tcx> cxxsdy fur die avx?nigf LLser, 
However, now you c'ln get even a decent color laser mcxlel for 
under $4t)0. You cxin also get MI'P versions of Liser printers. 
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Onci^ thing that people cion t realise b laser prints are far more 
dural )Ie. In fact, toner is ruaiiy small particles of plastic: atti-iu ied to 
the pai^ei; and then melted on tlie page. Tliis gives the gteiitest 
iimcxini of diin]l>jliiy fcir that piintoiit. Furtliermom, you can piiiit 
muc h Itiglicr volumes of laser prints more quickly than you can 
v^itli tiiost inkjets. So, lasers are see[i very often in the work 
environments where |X^rinanence Ls imjxjitant, as well as s[)eed. 

One of the things to rake note of when buying a laser is what 
toner c'^irtridges come with i[. Some nianiifaciurers give "starter" 
cartridges. While otliei-s give full caitridges to start. While this may 
seem insignificant at first, it cc3uld really be a couple hundied 
dollars difference in rc'ality. Make stiie you know what yott aie in 
Ibi; including tlic replacement cost.s of the cartridges. 

Take note, however. Some printers liave cartridges that ^ire jirsi 
the ink, bur then also have .separate print heads that netxl to Ix" 
rvpiaec'd pc‘riodically, Otliers, have the ink and print head 
integiuted into one cartridge. In tliose aises, ifs almost like getting 
a “new" printer when you get new cartridges, and can make a 
noliceable difference to print quality. 

A gcx)d Rile of thumi) Ibr lascni is that one toner c:artridge 
ctDOtams alxxit the s;inie amount of [:)rinting as ihiee ink jet 
canridges, 'Itiis is true for mast of tlie !U^ printers and the Qinon 
inkjet y)rinters tlial use llie print liead type ink cartridges 
BC-a2, HO20, etc.). 

Now, to make inatters mote confL3.sing, some of the inkjeLs 
ncjw' tout a lower cc xsl pc;r page than .some of the lasers. For extmple, 
weVe u.sed die HP C>Hkcici Pm 176^ and 17780 exicfisivcHy, and 
fbund the autridges lasi a coasidemble amount of time. 

Duty Cycle 

Duty cycle — the numixr of pages you exjxtt to print each 
diy or wet‘k or month — is another important consideration—^ and 
one in which lasers have die edge. Most [irinter nianufaeturers 
descriptions include rids info. If they don't, track it ikmn Ixdbre you 
(::ommit to a purc hase. And alw^ays — ALWAYS — see a quality of 
the print outfiut Ixfcjre I buying any type of printer. With so many 
choice's frerm exicli vendor, it's irnpomuit to maldi wlial the [irirUcr 
dtxs to what your needs are. 

Laser printers rccjuire regular maintenancx^ for the liest serv'ice, 
and tlxy am often lx leixiired ir.sonieUiing lireaks. InkjeLs, on the 
other, are like bwxnd DVD players diese days: disyxisable. ^llars 
not a gcKxl thing environmentally, hut .simply the wuy things wc)rk. 

If you clont need photo cjuality lasers may lx the Ixsl way to 
go. Lasers Iwe sharper text and une generally faster diaii tnkjets. 
WTilie tonei- cartridges are more expensive tliaii ink, they print more 
Images, ,sc) tlic axst per jxigc is often lower. In faci, the idea! sc\-up 
would lie to have a lasei- for text output and an inkjet for photos — 
and with airrent prices, that may lx a whole lot more tealistic diLin 
it used to lx. 

Printers for Photographers 

Hiere are almcxit as imny |)rinlei?> aimed at photogniphers as 
tliere are types of photographers tltemselves. Pro skxxeis should 
invest in a high-end photo printer that allowcs them to output prints 


up to 11 X 14 inches with fine detail. Such printers are sevenil 
htindiec.! bucks more than the average inkjei, but when your 
livelihood is involved, ills best ncji to .skimp. For example, HP's 
Photcxsimiit line i>riiUs Ixautiful [irinls, on a variety of media 
and sizes, but it wall c’ost you .several hundred dollais. 

If you're printing family shots, a less expensive, and moie 
com|Xit1, [)]k>io f)rinter will suffice. Printers like this — usually in 
the $ 125 to S175 range — offer g^xxl output, tlicxigli some ajmjxict 
j’lhoto printers can't print out m)nn;tl sized diKuments. Make ,sum 
yours can if that’s a need. 

Specs 

Pediaps the mtist imponant spec you'll need to know^ about a 
[mnter is tv.soludon, which is measured in dots per inch (dpi). This 
refers to the maximum numlx^r of dpi that can lx; printed, 
measured lx)lh hori7x>ntaIly anci vertically. For example, a 600 x 600 
dpi kiser printer lays down a une-incii stfuare cotnf^osed of 600 dots 
iiCTo.ss by 600 dots dowm, A printer with a liiglier lesolution is 
capable of prfiflnc ing morexletaiied text and imtigcs. 

New i^rinters vary (mm as low' as 600 x 600 and go up to 4800 
X 1200 dpi. Accordbig to the I'a'ewareFiles.com web site 
http://WWW, freeworefiles, corn/news/sKowarlicle.php?QrticlelD=15), 
there arctn’t really cases w'here text output requires that high dpi. In 
our ex|>erience, anytliing alx>ve 600x6(X) is a waste far text. Others 
would say tliat anytliing al:)ove 300x300 dpi Ls just a waste of ink, 
and sometimes even 300 x 300 is too high. 

Some printers also come with resolution enhant:ement 
technulog)^ (RET) technology or s<jftwaiv. Tliis b a Ibnn of image 
prcx'e.ssing technology used to manipulate dot characteristics 
(http ://en .wiki pedia.org/wiki/lmage_procesMng>. Most laser 
printers have [xinter engines that [>rini at eiOier 5X) dpi or 600 t\pi 
Using algorithms that recognize airved lines, a printer with 
rewdution enhanaanenr am prcxiuce tJUtput whose resolution 
apjx'ars to lx mucli higher than the print engine’s raicxl rc;si>lution. 
llib Is why many piinter m^inufacturers cliaracterize their printeis 
with two rew^lution ratings: the engine resolution and tlie effective 
rc'solution. A conunon rc‘soluiion enliancxanent :echnic|ix b lo vary 
the size of the dots. 

Yciu'il also need to Imow the s|ieed of your printer, w4iich b 
measunxl in pagers pt'r minute (TPM). Tlie higher the rating, the 
faster it can jirint. Naairally, printing text dtxumenLs is going Itj be 
a lot faster tlxin printing photos. But text speed can be adjusted (for 
example, HitKise drift mode for the faste.st printing), as can photos 
(often you can choose Ikim gcxxl, IxUlt and tx^sl type printing 
Options). Usually, tlie rating of Uie printer b done when in draft 
fbnnai. HiLs stuff is like mileiJge on ycuir car... )x>ur mileage may 
vttry. 

For tlie avciuge cunsumev, print s|xed may not lx that 
impvirtant. Lfnless you’re really in a hurry, ifs not going to imke that 
much difference whether it takes a dexument five setxmds or 10 to 
priiiL And if you’re [)rinting InglKiualiiy phouxs, well, just .slow 
down 'cause those take a bit of time, 

That said, be aware that there are two different speeds: average 
liuge ]xr minute and first fyage out. For m<xsi uses, unless you are 
printing multiple copies, hist page out is lar more important to you, 
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and imkes a recognizable difference to tnany people. Nothing like 
immediate sjiiisfaciion! 

But, if you arc a liustness user, print longer or 

buying a workgroup product, speed can make a huge difference. 
And, think about how much the time saving can mean for your 
staff. Again, a relaiively modest (100 licre iitay buy yt>u a wliofe lot 
more speed in something like a black and white laser In shorty 
match the capabilities with ycxir speed needs. 

Dye-based vs. pigment-based 

When it comes to inkjets, M.>me printers are dye-ba.sed, wliile 
tHfters are pigincnl-liascd. When it comes to clKxxsing ix^tweeti die 
two, experts generally agree that pigment-based ink prints last 
longer and often cost more while dye“based inks pn xluce a wider, 
more vivid range of colors Lliat fade more tjuickly. 

Tile tntxst inifxjitant reasons for using pigment inks ate 
archival print life, color stability, and many of‘ the fine an p?ipers 
require it 'Ihe dye inks usetl in mt]^! early inkjet printers (|uickly 
exlii[)ii signs iiS fading or color shifts. Aitd. wlien prints aie ex]X>sed 
to sunlight—like those fhimed BxlO wall prints of your kicLs xhxt the 
sun a>me$ through your window on—facie noticeably in a cxaipkr 
of yc^ars. 

As a result, ilie graphic art and fine an markets turned to 
pigment inks. Pigment inks are more stable and can last more than 
200 years on some paper types under idea! condilions. At least 
ihat’s the theory. Time will tell. 

Botli iy[x.\s use water and lx>tli aie sprayed on the paper, 'die 
main diffenence is dye ba,sed ink consists of a dye niixtxl in with 
the water (rind other cliemic'als) until die dye l xx:onic,s part of the 
li(|uid ink. PigmenL^rasexJ inks coaslsi tif tiny particles su.sjiended 
in liquid dial hit die ptiper and stick to it. Dyedxtsed inks feartiie 
liquid particles that actually get absorbed into the paper. 

For vtKM .siiiiatioas, eidier ink will provide cxcellein results; 
however pn>fessionals tend to use pigment leased ink systems that 
cost HKire, but are moie Resistant to humidity, and offer better color 
acairacy and image sharpness, according to Gebi Images 
(hi!p://www.gei^timages.com/lnks.htm), a site by pro jihotographc^, 
Al Geist. 

As more families witch to digital camenis, it makes .sense that 
ink jet prints will end up replacing Lliose snapsluXs, lie says. Since 
tliese prinLs arc primarily for ixtsonal enjoyment, and diey can Ix^ 
easily rcprintc^l is someone splashes water on them, or they drop 
00 the floor and get .stepped on, longevity isn't a re;il tx>nt:em, Cicisl 
notes, 

Printers that use j^igment-lxised inks are more cx>mmon xhm 
they were a few years ago, Ixil they .still aren’t the m<xsi cximmon. 
Tills is t)ecxiuse tiye-lxLscd inks aist less and produce a liigger 
range of colors tlian pigmented inks — which Is fine for mast users. 

Connectivity 

Most all consumer printers now^ sfxirt USB 2.0 connectivity 
(and if’ you find one di:u do^n't, you prolxibly don't want to buy 
it). You Gin still hity printers tliai interface with 25-pin parallel 
cafilcs — for tliosc* dial like to kick it of .sctuxil. 


Workgroup printers supptirt printing over a netw^ork using a 
standard Ediemet cable with an KJ45 a)nriector. And an increasing 
number of printers stipport wireles.s printing, using infrared, 
Bluetcxxh, and Wi-Fi acx■e^s points witli Iniik-in ]>rint servers. 

Dqx^nding on your needs and use, one major thing is to figure 
out how users will find (aka discover) the printers you set up. This 
is impoitani whether ycnir connection is wireless or waited. In the 
Mac space, we have the Bon jour technology to make auto 
discoverability vciy easy. I IPs product line, as an example, has 
100% compatibility all the way through their network printer line 
(from t:onsutTK^r through die lugli end). Odiers may as well. For 
almast all installations, Bonjoiir will work beauiifuDy and allow 
users to find, and configure, dieir printers themselves. 

But. Bon jour only wxirks for printers on ihe same subnet so 
HTs (and otlieisj apprxiach is to allow for you to discover a printer 
by giving art IP address, llils allows you Et> connect to a printer via 
an IP address to go across your LAN, WAN or even die Internet. 

The important part hero Is to figure out w^hat type of 
ctrnneclivity you need and wkit users yoitH have. Do you need to 
sltate the printer’:' How^ will that Ix^ done (Hthemet, wireless, in 
printer sharing).^ If it's Mac Ofi Xs Printer Slutting feature, is the 
macfiine your printer Is lKx>ked up to always available? 

Paper and Media Handling 

You'll want to make sua* your printer Gin handle the paper 
sizes you need (or want) to work wath. All desktt^p inkjeis and b.ser 
printers worth their .salt print on .standard paper (leuer and legal 
sizes) and envdoptrs. lJnk?ss you're buying a jxatable printer, don’t 
go for a model dial holds less than ItXj sheets of paper. If you need 
advanced paper-handling feaaires — such a.s rabloid-size printing, 
duplexing (printing on Ixjth sides), arid aino dtK'iimenl feeders for 
faxing and ctipyiog — you’ro* kxjkirig for a mid-range to liigli-end 
printer. 

Another important item to kxjk at when .sekrting a printer Is 
what types of payxT it c^an handle. Do you ncxxl to yrrint Iranners? 
Make sure die yjrinler can liandle huge output. Business airds? 
Make sure it Gin handle sinall media. Also, don't nea^ssarily go fiyr 
die chGipest pafxtr. Some t^heaper papers wall absorl) die ink at 
different rates and tills ean mar the print quality of die colors of text 
iw grajiltic’s. 

In prior years, configuring your printer to print pn>|x:iiy on 
each different type of pjpcT was tiiiutx‘rsomc al liest, and leally 
cjuitc confusing for many jicofile. Most people used trial and error 
to figure it out wliich wastes a lot of expeasive ink as well as papti'. 
Many of’the printers have a sensor to detennine whedier the yraf^r 
is plain <ir phtao fxipcT. Tills helps widi auUxonfiguring die printer 
U> jjut down die projx:*r amount of ink to get die Ixf^t print quality 
for each type of paper. Furtliermoie. some of the papeoi, like die 
aclvanced photo papers from HP, have a liar cxxJc tm die Ixick diat 
allows the printer to know' exaedy die type of paper, llie advanced 
pajK^rs liave die ability to print much faster dian nonnal photo 
papers. 

Do you need to print on DVD.s or CDs? It’.s amazing how^ few' 
(if the yyliolo printers liave ilie aliility to do diis, and don’t even ir>' 
to attack it on a laser, 'lliat Siiid, if you don't need to print right on 
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die disc, you can go to on of die siic’ker stiluiitjns to apply 

a lalxl to your tli^x But, Mime (even inexpensive) photo printers 
do have die ahdity' to print one disc at a time widi Lieautifiil resulis. 
Ifs all a matter of what your neetis are. 

Energy efficiency 

Witli more and more of us looking to try to live a litde 
“greener" for Mother Fiirdi, you miglil also consider the eneigy 
efficiency of your printer Tile US Department of Energy 
(htip://wwwKeere,energy. 9 ov/femp/pdfs/printer.pc}f) ofTers some 
ti|xs on buying an energy-eflicicnl coiniiutcr printer. 

If you’re btiying a medium- or high-speed User printer that 
prexJuces at least 6,tXX>-^,000 pages per monili, you may wdni to 
clitxjsc a imxlei with duplexing (avo-sided firiniing) capability. 
Duplexing is often a standiird feature on printeis with speeds above 
40 ppm. Duplexing printers save on paper costs, as well as 
providing odier IxwtiLs such as lower postage ciosts, reduced flic 
space, etc. *lhe added cost of a printer dufilex aitacliment Ls often 
mpaid in two years or k'ss. 

ALst>, imike suie the powc^ mjinagenieni anti duplexing 
features of your printer have been “enabled" at the [>rinler and that 
duplexing Is the ck'fiiult setting widiin rach users softwTue, .Set the 
“wuni time*’ prior to sleep TiKide as short as passible, coasistent with 
u.ser needs. Even for printers with a low-power sleep mcxle, you 
can save more eneigy if you manually shut them olT aimpletely at 
night and on wc'ektrrxls. A few printer models do not liave a 
mitnual on/tjlT switch; these am lx shut oft using an external 
“power strip’’ (suige proteaor). 

Networked systems that allow several neariiy users to slxtre a 
single (faster) printer genenilly s;tve tiiiie, cost, and energy 
cximpaied with each computer having a dedicfited printer In stime 
eases, an older printer tliat does not h:ive an ENERGY STAR sleep 
mcKle cjm still lx power-managed using an external contix^l device. 
External controls switch the printer off (rather than into sleep 
nuxle.) after a [ireset time, and switch it on again when a “firinf 
signal is tet:eivetl. EIW.s wdi site and hotline jitovide a list of 
external printer aintroLs. 

Cutting costs 


Wliat alxiut extended wximuities? fhe Washin^^on Post 
(http://reviews.washingtonposEcom/contenf/Prrinter-Buying- 
Guide.htm) says you should '*ihink very ha id lx4dre you purchase 
any kind of extended warranty” W]ly? “Rrinteis already come wirli 
a manufacturer’s wiiminly, and if you purchase w'itli a credit card 
you may gel additional cx^wrage from them Most firinters am so 
inexpenswe nowmiays that in the cTent tlie manufacturer’s wammty’ 
lias expired, it’s cheaper to just go out and get a TCplacemenL You 
may want to think alxxit an extended warranty if y<xi are buying a 
more expensive printer or if you are going to use it a lot or travel 
with it.” 

Miscellaneous Considerations 

Something that may lx.- of imfxrrUince to you is a printer that 
supports Ciimera c'aal skx technology btiilt right into the printcT. It 
allows image's to lie printed directly fn>m digital anneras to a 
prinier, without having to conned tlie aunera to a computer by 
having slots for the memory atrds. Wliat is txxil alxKit this Is that 
many times, you c'an mount the memory ctini on your Mac and use 
the printer as a maxs srnmge dnace (e,g., a caid reader) .simikir to 
plugging in a flash drive directly into your cximputer. 

Some printers also use a technok^ t:alleti EittBridge: an 
industry standaal for connecting yotir camera right up to tlie 
printer, and controlling tlie printing from tlie camera. If you’re 
printing from a catuera phone, Bluetooth wareless compatibility am 
tome in liandy. Bkiettxxii capaliiliry' Is Ixx'oming more cxaiimon in 
camera {ihones, 

Most phones wiiii BlueLcxdi technology will also lx» able to 
send your pictures dimetly to a printer. If tills inteiesls you, iiiitke 
.sure tliat you get a Bluetooth ermbled printer — or at Icusi one 
tliafs Bluetooth capable. RlueUxith oipabiliiy for printer is 
commonly offered via an optional adapter by printer 
manufaclURis, and is .sometimes built dirmly into ilie fmnicT. 

if you're a nxid warrior, you may need a fx>rtab)e printer. 
'Ihese weigh ;mywhere from 2-5 jxninds and aie liig enough to lei 
ytni print on a standard 8.5-i!ic5vwicle sheet of paper The jiriiU 
sfKxxis and the inuige quality aren’t top of tht* line. Portable printers 
typically cost around S300—as with lafXO[)s a>nip:ired with 
desktops, you'R' ixiying fur the poitabiHry: 


Generic inks tliat are nxinufactiiied by comi>anies other than 
the printer nxinufitturer c'an we you some bucks, but it am also 
tiiuse you heart at he. First, lx: sure to find out if a generic ink 
i^trtiitlgc is a>m|iatihle with your printer. Some manufactuieis 
[jrevent other cximpinies from milking ink cartritlges for its printers. 
If this is important to you, clictrk it out in advance^. 

Inteivsttngly, weVe found that some generic scalutions in Ixxh 
laser printers and inkjeis prodtice vastly lower C[uality results. 
Qtheis, howev^a; do a greai job. Tliai s;iid, some of the 
imnufacturers are figuring tilings ouf and aiv prtxiudng solutioas 
tliat yield a higlier numlxfr of piinied pages than .some generics. 

While it’s often possible to save money using non- 
manufacturer printing solutions, thcTc’s work involved in 
finding who to fiuy from, and w^hether you are actually able 
to save in the end. 


Concluding Advice 


As ytju am see, there are lots of options to coasider w'hen 
buyitig a printer. Bur witli a little planning and comparison 
shrrpping, you am find tjne tliat fiLs your needs and budget. Your 
first step is to go thn>ug]i tire different ama.s of this article and 
dexide wluu do you need and wfxit would (x- nkie, and tlien use 
that CO figure out which printers make the most sease for you, 

Grte thing to realize. If your printer is more than a couple 
of years old, it prtibably makes sense to get a new one instead 
of getting more toner or ink. ’fhe printers Uicmselves cast almost 
nothing by comparison, and you may as well Ixfneftt From all 
that the new printers have to offer whether that’s quality. 


speed, or feaWires. 
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The MacTech DVD - Volumes 1.01-24.T 2 is packed with more than ever before - 
almost 3100 articles from more than 280 issues (1984 - 2008) written by over 850 
experts, all 29 issues of Apple's develop, 21 issues of FrameWorks magazine, 

100+ MB of source code, MacTech Viewer, working applications, full 
documentation, demos for techs, and more! The latest version includes 
all kinds of third party applications, videos, and demos. 




Everything is displayed in the very fast, 
very searchable MacTech Viewer! An application that 
has been designed specifically with Techs in mind. 
Search quickly through almost 25 years of of great 
Information provided by MacTech. Information to 
save you time, and make your life easier. 



Requires Mac OS X v. 10.4.5 or later 



Toll Free 877-MACrECH, Outside US/Canada: 805-494-9797 • http://www.mactech.com/dvd/ 


























REAL WORLD REVIEW: HP Printers 


As with fimny MiK'Ttx'h a nicies, we focused on a real world experiente to a gtx>d handle on tlie issties of why ymCd use one [printer 
ret'hnolo^ over anotlicr Tliis Ls vastly more revealing than jiisi throwing a [:irinter on a test bench, and playing with it for a ct>iiple of hours. 
For thus article, we focused on a single iiianufacluner so lliat we tiiid a more consistent basis ftir comparisoiL In tills case, we used a wide 
variety of HP printers in real liic use, some of which are lielow here. Prices listed are list jirices, and (Jiere are many deiils and nclmtc-s out 
tliere that make these printers a w'hole lot moa^ aftbrdable than even Uiesc jirices. 


HP Photosmart A636. We 
kxiked at an earlier model 
(the A7i6X This printer is 
super .small (less than 10 
inches wide and about 3 
pounds). Pictures are 
average tjuality, but this is a 
great portable printer if you need it. It uses a tri-color cartridge 
which saves on sfiace, but is less efficient. Size and portability 
dcfiniLely the reasons to get this printer. SI50 


HP laseijet P1505- We Ux^ked at 
the previous 1022nw (wliich 
also had WiFi). This is an 
incvediiile printer. Low price. 
Fast, Nerworktxl making it easy 
to share. A real work horse for 
MW' laser printing. Akmg with 
the L7780, one of our most used 
printers. We strongly recommend a printer like this in your 
stable if you do any t|itaniity of priming. S250 




HP Photosmart D5460. We looked 
at tlie D5160 pretiecessor, but this 
primer Is a st)lid pluHo jirinter that 
can prim Cl)/l)VI)s (a definite 
win). It too combines color into a 
single cartridge which puls it at the 
lower end of photo quality. We 
particularly like the really gootl 
looking CD/DVl) printing that it can do which makes a huge 
impact when you hand a disc' with a nice color image right on 
the disc'. $99 



HP Photosmait Pro B9180. An awesome pro level photo primer 

that allow.s for a wide 
variety of ink colors, 
paper .size.s/types, and 
has an Ethernet 
connection to share it. 
'Hus unit ha.s four 
separate print heads, and eight ink cartridges to really focus on 
quality photo printing. PajxT sizes up to 13 x 19 in. Clearly, if 
you are n pro level phoiograplier, this is the tyjx of printer that 
you need lo move towards for quality of the print, as well as 
ilie pajxr options, $7(X) 




HP OfficeJet Pro L7780 or L7680 
(wdtlioiil the extra psiper tray). This 
is an awest>ine MFP inkjet. A 
great solution to share at htime or 
in a siixill office. Lower printing 
co,st per page than the color 
la.sers. Nelw^orkable printing, 
faxing, and scanning. Decent 
tlualily photos. This is simply one of our fav<)rile printers in the 
pack, and one of our tnost in refill world usage. $500 


(L7680: $400). 



HP Cobr LaserJet CP1518, It's 
amazing to think of getting a 
color laser for so little cost. 
Toners can lx expen.sive, .so 
think through your supply 
ctjsls. We ended up using this 
printer less in real world usage 
IxaiLise as a color laser, it 
doesn't handle photos as well as an inkjet. That said, if you are 
doing lousiness class documents and handouts, it's a vastly 
Ix^tter way to go than an inkjet for it's text crispne.ss on tlie 
page, and durability of the print. $400 



two P1505's. or even bump u\ 
need a B^tW laser in betweti 


HP LaserJet P3005. If you prim a 
lot of Bt^W, litis can be your 
(ype of solution. Larger paper 
trays and output is the biggest 
advantage over the PI50'>, 
lieally targeid for the workgroup 
and larger settings. But, many 
times, it may be easier to have 
I to the CM4730. That said, if you 
, this is it. $550 




Color LaserJet CM4730 
Heplaces the 4730mfp that we kK)ked at. 
The.se arc fabulous nxichines for the 
t)ffice- And. even at the larger tag, it 
replaces your MW and ct)!or lasers, tax, 
copy machine, and scanner Clearly our 
highest volume unit, and ifs very 
capable. We routinely u.sed litis machine 
to print from remote offices, over the 
Internet, to the main office for everything 
frtjiii single page cx)ver letters, lo larger 
dtx'utiicms. If this printer fits your size, its a solid work liorse, 
and a welcome atldition. $5000 
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THE MACTECH SPOTUGHT 



I'hC. 



What do you do? 

Founder and CFO 

How long have you been doing what you do? 

Fve l^en writing code for the Mac since 1985. 

Your first computer: 

512K“Fat Mac'* w'ith external floppy drive and Image Writer 

n. 

Are you Mac-only, or a muldrplatform persoa^ 

Professionally. Fve only written code for Mac OS and Mac 
OS X (the latter really including Unix, by extension), with some 
brief detours into in-house OS development. 

What attracts you to working on the Mac? 

1 was originally attracted to the Mac by its ease of use, 
attention to detail and consistency in the user experience, and 
overall fit and finish relative to what was available at lire time. 


'today, ihtxse characteristics are still what keep me working on | 

the Mac. I 

I 

I 

What's the coolest thing about the Mac? 

1 diink the coolest thing about ihe Mac is its repeated * 
ability to ' wow** anyone w'ho's never seen one in operation* by 
doing things iliai wc consider ordinary and appuipriaLc, but 
which are unusual or impossible on oilier f>lalfomis - like 
tnoving a window hetw^een two displays without even thinking 
alx)Ut it. Tilings like this astonish and please those wiio never 
thought it possiide. 

As Mac users first, we've lichen inspired t)y this to make our 
prcxiucts operate the same w^ay ^ dmigs work the way tliey 
should, and customers are frequently astonished wlien the 
skeptical "Will tliis work?" is answered with a definilc "Yes." 

What is the advice you'd give to someone trying to get into this 
line of work today? 

It's the same advice Fd give if I etitild go back in time 
iw'eiity years. :-) Start with a prtxiuct concept that will ouilast 
current fatis and fashions, and wiiich bearing on prolilems lliat 
are personally im]xjitant to you; exeexite that concept using 
solid engineering discipline, anti bearing in mind that you \XiLF 
have customers to sup|-H>ri, so your engineering decisions 
should also be informed by how^ they cirntribuie to the 
.supporlability (or lack thereof) of your product. 

What's the coolest tech thing you've done using OS X? 

Running a dungeon in World of Warcraft with a group of 
friends wliile liuilding a GM release of a major BBKdit upgrade. 

Where can we see a sample of your work? 

All of our pi fxlucrs am available for downloading from our 
w'eb site; the ('omnierdal products are provided as 30-day 
derno versions, arid the freeware products are of course non- 
ex j>i ring. 

The next way Fm going to impact the Mac universe is: 

1 don't know. >) I’ve learned from long experience that the 
future is unpredictable, and srjmeiimes even when you "know" 
what youTe doing next, life can change so that what you 
‘‘know" isn’t true anymore. 

7ili 


If yov or someme you know behags m Hie MacTedi Spo^gkt, kt os 
know! Send detaSs to eStork^maedumi 
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set the latest now 

» P9y for it IStCr (wftkocdde^it) 


How? With a Business Lease from Small Dos Electronics. 

Don't put off getting new equipment for your business. Small Dog Electronics will outfit 
your small, medium or large business with everything you need-and within your budget. 

Benefits include: 


» multiple leasins plans & companies 

Two major leasing companies & numerous plans are available to ensure a perfect fit 

»lease-specific product specials 

Take advantage of special deals only offered with a lease agreement 

»flexible buy-out plans with no commitment to buy 

Turn over your equipment as the need arises to always have the latest & greatest. 

» and more 


Plus, every shipment outside of Vermont is always tax-free, and our award-winning 
customer service staff is ready to answer any question you may have. Contact us today- 
we're confident that we have a plan that will suit your needs. 

There's more online! Visit Smalldog.com/fiinance 

Contact us for a free quote: email Rob@smaildog.com or call 800-511-MACS x620. 



Small Dog 

Electronics 


T^oijir €ide 


• over 15 years in the Nac community 

• 3,000+ proaucts for Macs + PCs 

• 5-star online merchant rating 

• tax-free shopping outside of VT 


www.smalldog.com 


SOO'-Sll-MACS 


ll Apple Specialist 















FREE ' 
UPS Shipping! 

Qrl JJi05rc?r<fe5 <m ' 99 .fsbol}^ 


SAVE ^ 644 ! 

15" MacBook’Pro 2.4GHz 

FREE Parallels Desktopl' FREE Epson Printer!' 

original price ® 1994 S | 

^1449^-^100 maihin rebate — f 

*AfiermaiNn rebate. Call for detaih. 


m9U39 


Your Mac!. 

Free Parallels Desktop 
after rebate and nnore! 


Source code: MACTECH 


Authorized Rese er 


Your^l Apple Superstore! 


Call 1-877-233-2838 or visit macma l.com 


6 Months Same as Cash! 

OUer vai'id hmchcm averWO. 

Up to ^250 Cash Back! 

rtfefte 

FREE Parallels Desktopl 

After lebate ptirdmieotan Appfeajm^titer. 

FREE Epson Printer! 

reJxjEs purchase 
ofwAppk^comptjitier 
offers 


SAVE 5 S 94 I 

13" MacBook" Air 1.6GHz 
80GB Hard Drive 
FREE Parallels Desktop!' 
FREE Epson Printer!’ 
original price^}794 

(,299® ■^7 

ff7373085 *AftermQit4n rebate. 


SAVE nOO! 

15" MacBook Pro 2.4GHz 
9600M SuperDrive 
FREE Parallel Desktop!' 
FREE Epson Printer!' 

MSM'' roo=f'7S ^4^/ 

7634020 ^AftermaiHn rebate. 


SAVEM1! 

Microsoft Office 2008 
for the Mac Student 
and Teacher Edition 

list price ^149^^ 

t7i52258 'After ‘IS instant rebate, 
Wftfly!OftBren*?/(!WS. 


MASSIVE STORAGE!. 

ITB LaCie Big Disk 
Extreme+ USB 2.0, 
FireWire 800 and 
FireWire 400 Hard Drive 


/797H. 


5AVE>50! 

13" MacBook'2GHz 
SuperDrive' 

FREE Parallels Desktop!' 
FREE Epson Printer!' 


^t294 ‘50=^1244l! 

^7684018 ^AftermalNn rebate. 


























